SeleniumLibrary4.5.0 关键字详解（九）

SeleniumLibrary4.5.0 关键字详解(九)

库版本：4.5.0
库范围：全局
命名参数：受支持

简介
SeleniumLibrary是Robot Framework的Web测试库。

本文档说明了如何使用SeleniumLibrary提供的关键字。 有关安装，支持等信息，请参见 python3.9.0 + robotframework + selenium3 实例体验。

有关robotframework框架的更多信息，请参见 https://blog.csdn.net/mask5726/category_10537277.html。

SeleniumLibrary在内部使用Selenium WebDriver模块来控制Web浏览器。 有关常规Selenium的更多信息，请参见http://seleniumhq.org。

内容列表
1、元素定位
2、浏览器和窗口
3、超时，等待和延迟
4、运行故障功能
5、布尔参数
6、webDriver事件
7、线程支持
8、插件
9、引入
11、关键字

关键字
90 Maximize Browser Window
说明：

最大化当前浏览器窗口。

91 Mouse Down
参数：

locator

说明：

模拟在元素定位器上按下鼠标左键。

有关定位器语法的详细信息，请参见“定位元素”部分。

在不释放鼠标键的情况下按下元素。

另请参见更具体的关键字Mouse Down On Image”和“Mouse Down On Link”。

92 Mouse Down On Image
参数：

locator

说明：

在定位器识别的图像上模拟鼠标按下事件。

有关定位器语法的详细信息，请参见“定位元素”部分。使用默认定位器策略时，将使用id，name，src和alt搜索图像。

93 Mouse Down On Link
参数：

locator

说明：

模拟定位器标识的链接上的鼠标按下事件。

有关定位器语法的详细信息，请参见“定位元素”部分。使用默认定位器策略时，将使用id，名称，href和链接文本搜索链接。

94 Mouse Out
参数：

locator

说明：

模拟将鼠标移离元素定位器。

有关定位器语法的详细信息，请参见“定位元素”部分。

95 Mouse Over
参数：

locator

说明：

模拟将鼠标悬停在元素定位器上。

有关定位器语法的详细信息，请参见“定位元素”部分。

96 Mouse Up
参数：

locator

说明：

模拟释放元素定位器上的鼠标左键。

有关定位器语法的详细信息，请参见“定位元素”部分。

97 Open Browser
参数：

url=None
browser=firefox
alias=None
remote_url=False
desired_capabilities=None
ff_profile_dir=None
options=None
service_log_path=None
executable_path=None

说明：

打开一个新的浏览器实例到可选的URL。

browser参数指定要使用的浏览器。下表列出了受支持的浏览器。浏览器名称不区分大小写，某些浏览器具有多个受支持的名称。

Browser Name(s)
Firefox firefox, ff
Google Chrome googlechrome, chrome, gc
Headless Firefox headlessfirefox
Headless Chrome headlesschrome
Internet Explorer internetexplorer, ie
Edge edge
Safari safari
Opera opera
Android android
Iphone iphone
PhantomJS phantomjs
HTMLUnit htmlunit
HTMLUnit with Javascript htmlunitwithjs
为了能够实际使用这些浏览器之一，您需要具有匹配的Selenium浏览器驱动程序。有关更多详细信息，请参见项目文档。 HeadlessFirefox和 HeadlessChrome是SeleniumLibrary 3.1.0中的新增功能，并且需要Selenium 3.8.0或更高版本。

打开浏览器后，可以使用可选的URL将浏览器导航到所需的地址。

可选别名是为此浏览器实例提供的别名，可用于在浏览器之间进行切换。当给两个别名使用相同的别名时，第一个关键字将打开一个新的浏览器，而第二个关键字将切换到已经打开的浏览器，并且不会打开一个新的浏览器。别名定义会覆盖浏览器定义。如果使用相同的别名但定义了不同的浏览器，则切换到具有相同别名的浏览器并且不会打开新的浏览器。切换的另一种方法是使用此关键字返回的索引。这些索引从1开始，在打开新的浏览器时递增，在调用“关闭所有浏览器”时重置为1。有关更多信息和示例，请参见切换浏览器。

可选的remote_url是Selenium Grid的URL。

使用Sauce Labs时，可选的required_capabilities可用于配置浏览器或浏览器和操作系统的日志记录首选项。可以使用Python字典或格式为key1：value1，key2：value2的字符串来提供所需的功能。 Selenium文档列出了可以启用的可能功能。

如果您希望覆盖Selenium使用的默认配置文件，则可选的ff_profile_dir是Firefox配置文件目录的路径。请注意，在SeleniumLibrary 3.0之前，该库包含其自己的配置文件，默认情况下使用该配置文件。 ff_profile_dir也可以是selenium.webdriver.FirefoxProfile的实例。第三种选择是，可以使用FirefoxProfile方法和属性以与options参数相同的方式使用方法和属性来定义配置文件。示例：可以使用FirefoxProfile set_preference定义不同的配置文件设置。请参阅下面的选项参数文档，了解如何处理反斜杠转义。

可选options参数允许定义浏览器特定的Selenium选项。在Chrome的示例中，options参数允许定义以下方法和属性，对于Firefox，这些方法和属性可用。请注意，并非SeleniumLibrary支持的所有浏览器都提供Selenium选项。因此，请查阅Selenium文档，哪些浏览器确实支持Selenium选项。如果浏览器参数是android，则使用Chrome选项。selenium选项也可提供。当使用remote_url参数时，也支持Selenium选项。

SeleniumLibrary选项参数接受两种不同格式的Selenium选项：作为字符串和作为Selenium选项类实例的Python对象。

字符串格式允许在Robot Framework测试数据中定义Selenium选项方法或属性及其参数。方法和属性名称区分大小写和空格，并且必须与Selenium选项的方法和属性名称匹