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、关键字

关键字
78 Handle Alert
参数：

action=ACCEPT
timeout=None

说明：

处理当前警报并返回其消息。

默认情况下，警报被接受，但是可以通过支持以下不区分大小写值的action参数来控制警报：

ACCEPT: 接受警报，即按确定。默认。
DISMISS: 关闭警报，即按“ Cancel”。
LEAVE: 离开打开的警报。
timeout参数指定等待警报显示多长时间。如果未给出，则使用全局默认超时。

例子:

Handle Alert # Accept alert.
Handle Alert action=DISMISS # Dismiss alert.
Handle Alert timeout=10 s # Use custom timeout and accept alert.
Handle Alert DISMISS 1 min # Use custom timeout and dismiss alert.
${message} = Handle Alert # Accept alert and get its message.
${message} = Handle Alert LEAVE # Leave alert open and get its message.
SeleniumLibrary 3.0中的新功能。

79 Input Password
参数：

locator
password
clear=True

说明：

在定位器标识的文本字段中输入给定的密码。

有关定位器语法的详细信息，请参见“定位元素”部分。有关明确的参数详细信息，请参见输入文本。

与输入文本相比，区别在于此关键字不在INFO级别记录给定密码。请注意，如果您使用类似的关键字

Input Password password_field password
密码显示为常规关键字参数。一种避免这种情况的方法是使用类似

Input Password password_field ${PASSWORD}
请注意，如果不应以任何格式记录密码，则Robot Framework将使用TRACE级别记录所有参数，并且不得使用低于DEBUG的级别执行测试。

clear argument 是SeleniumLibrary 4.0中的新增功能。从Selenium日志中隐藏密码日志记录是SeleniumLibrary 4.2中的新增功能。

80 Input Text
参数：

locator
text
clear=True

说明：

在定位器标识的文本字段中输入给定文本。

如果clear为true，则在将文本键入到元素之前，将清除输入元素。如果为false，则不会从元素中清除之前的文本。如果您不想记录给定的文本，请使用输入密码。

如果使用了Selenium Grid，并且text参数指向文件系统中的文件，则此关键字将阻止Selenium将文件传输到Selenium Grid集线器。继而，此关键字将按原样将文本字符串发送到元素。如果要将文件传输到集线器并执行上传，请使用“选择文件”关键字。

有关定位器语法的详细信息，请参见“定位元素”部分。如何处理布尔值，请参见布尔参数部分。

禁用文件上传功能Selenium Grid节点和clear参数是SeleniumLibrary 4.0中的新增功能

81 Input Text Into Alert
参数：

text
action=ACCEPT
timeout=None

说明：

在警报的输入字段中输入给定文本。

默认情况下会接受警报，但是可以通过使用与操作警报相同的操作参数来控制行为。

超时指定等待警报显示多长时间。如果未给出，则使用全局默认超时。

SeleniumLibrary 3.0中的新功能。

82 List Selection Should Be
参数：

locator
*expected

说明：

验证选择列表定位器是否已选择了预期的选项。

既可以将可见的标签也可以作为值提供期望的选项。从SeleniumLibrary 3.0开始，无法混合标签和值。所选选项的顺序未得到验证。

如果没有给出期望的选项，则验证列表没有选择。一个更明确的选择是使用“列表应无选择”。

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

例子：

List Selection Should Be gender Female
List Selection Should Be interests Test Automation Python
83 List Should Have No Selections
参数：

locator

说明：

验证选择列表定位器没有选择任何选项。

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

84 Location Should Be
参数：

url
message=None

说明：

验证当前URL是否完全是预期url。

url参数包含浏览器中应该存在的确切URL。

message参数可用于覆盖默认错误消息。

message参数在SeleniumLibrary 3.2.0中是新的。

85 Location Should Contain
参数：

expected
message=None

说明：

验证当前URL是否包含预期的URL。

预期参数包含网址中的预期值。

message参数可用于覆盖默认错误消息。

message参数在SeleniumLibrary 3.2.0中是新的。

86 Locator Should Match X Times
参数：

locator
x
message=None
loglevel=TRACE

说明：

在SeleniumLibrary 4.0中已弃用，请改用 Page Should Contain Element。

87 Log Location
说明：

记录并返回当前浏览器窗口的URL。

88 Log Source
参数：

loglevel=INFO

说明：

记录并返回当前页面或框架的HTML源。

loglevel参数定义使用的日志级别。 有效的日志级别为WARN，INFO（默认），DEBUG，TRACE和NONE（不记录）。

89 Log Title
说明：

记录并返回当前页面的标题。