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

关键字
145 Table Cell Should Contain
参数：

locator
row
column
expected
loglevel=TRACE

说明：

验证表格单元格包含预期的文本。

请参阅此关键字在内部使用的``Get Table Cell’'以获取有关可接受参数的说明。

146 Table Column Should Contain
参数：

locator
column
expected
loglevel=TRACE

说明：

验证表列是否包含预期的文本。

该表使用定位符定位，其列使用列查找。有关定位器语法的详细信息，请参见``定位元素’'部分。

列索引从1开始。可以使用负索引从头开始引用列，因此-1是最后一列，-2是倒数第二，依此类推。

如果表包含跨越多个列的单元格，则这些合并的单元格将计为单个列。

有关日志级别参数的说明，请参见Page Should Contain Element 。

147 Table Footer Should Contain
参数：

locator
expected
loglevel=TRACE

说明：

验证表尾是否包含预期的文本。

元素内的任何元素均被视为页脚的一部分。

该表是使用locator参数定位的。有关定位器语法的详细信息，请参见``定位元素’'部分。

有关日志级别参数的说明，请参见 Page Should Contain Element。

148 Table Header Should Contain
参数：

locator
expected
loglevel=TRACE

说明：

验证表头是否包含预期的文本。

表中任何地方的任何元素都被视为表头的一部分。

该表使用定位符进行定位。有关定位器语法的详细信息，请参见``定位元素’'部分。

有关日志级别参数的说明，请参 Page Should Contain Element 。

149 Table Row Should Contain
参数：

locator
row
expected
loglevel=TRACE

说明：

验证表行是否包含预期的文本。

该表使用定位符定位，其列使用列查找。有关定位器语法的详细信息，请参见``定位元素’'部分。

行索引从1开始。可以使用负索引从末尾引用行，因此-1是最后一行，-2是倒数第二行，依此类推。

如果表包含跨越多行的单元格，则仅对那些合并单元格的最上一行进行匹配。

有关日志级别参数的说明，请参见Page Should Contain Element。

150 Table Should Contain
参数：

locator
expected
loglevel=TRACE

说明：

验证表中是否包含预期的文本。

该表是使用locator参数定位的。有关定位器语法的详细信息，请参见``定位元素’'部分。

有关日志级别参数的说明，请参见Page Should Contain Element。

151 Textarea Should Contain
参数：

locator
expected
message=None

说明：

验证定位器标识的文本区域是否包含预期的文本。

message可以用来覆盖默认错误消息。

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

152 Textarea Value Should Be
参数：

locator
expected
message=None

说明：

验证定位符标识的文本区域是否具有预期的准确文本。

message可以用来覆盖默认错误消息。

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

153 Textfield Should Contain
参数：

locator
expected
message=None

说明：

验证文本字段定位符是否包含预期的文本。

message可以用来覆盖默认错误消息。

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

154 Textfield Value Should Be
参数：

locator
expected
message=None

说明：

验证文本字段值是否具有正确的文本。

message可以用来覆盖默认错误消息。

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

155 Title Should Be
参数：

title
message=None

说明：

验证当前页面标题是否等于title参数的标题。

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

message参数是SeleniumLibrary 3.1中的新增功能。

156 Unselect All From List
参数：

locator

说明：

从多选列表定位器中取消选择所有选项。

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

SeleniumLibrary 3.0中的新功能。

157 Unselect Checkbox
参数：

locator

说明：

删除由定位器标识的复选框的选择。

如果未选中该复选框，则不执行任何操作。

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

158 Unselect Frame
说明：

将主框架设置为当前框架。

在实践中取消上一个``Select Frame’'调用。

159 Unselect From List By Index
参数：

locator
*indexes

说明：

通过索引从选择列表定位器中取消选择选项。

列表选项的索引从0开始。此关键字仅适用于多选列表。

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

160 Unselect From List By Label
参数：

locator
*labels

说明：

通过标签从选择列表定位器中取消选择选项。

此关键字仅适用于多选列表。

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

161 Unselect From List By Value
参数：

locator
*values

说明：

按值从选择列表定位器中取消选择选项。

此关键字仅适用于多选列表。

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

162 Wait For Condition
参数：

condition
timeout=None
error=None

说明：

等待直到条件为真或超时到期。

条件可以是任意JavaScript表达式，但它必须返回一个要求值的值。有关访问页面内容的信息，请参见执行JavaScript。

如果超时在条件变为真之前到期，则失败。有关使用超时及其默认值的更多信息，请参见超时部分。

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

例子:

Wait For Condition return document.title == “New Title”
Wait For Condition return jQuery.active == 0
Wait For Condition style = document.querySelector(‘h1’).style; return style.background == “red” && style.color == “white”
163 Wait Until Element Contains
参数：

locator
text
timeout=None
error=None

说明：

等待直到元素定位符包含文本。

如果超时在文本出现之前失效，则失败。有关使用超时及其默认值的更多信息，请参见超时''部分;有关定位器语法的详细信息，请参见定位元素’'部分。

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

164 Wait Until Element Does Not Contain
参数：

locator
text
timeout=None
error=None

说明：

等待直到元素定位符不包含文本。

如果超时在文本消失之前失效，则失败。有关使用超时及其默认值的更多信息，请参见超时''部分;有关定位器语法的详细信息，请参见定位元素’'部分。

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

165 Wait Until Element Is Enabled
参数：

locator
timeout=None
error=None

说明：

等待直到定位器标识的元素启用。

如果元素既未禁用也不是只读的，则认为已启用。

如果超时在启用元素之前过期，则失败。有关使用超时及其默认值的更多信息，请参见超时''部分;有关定位器语法的详细信息，请参见定位元素’'部分。

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

认为只读元素是不可用的是SeleniumLibrary 3.0中的一项新功能。

166 Wait Until Element Is Not Visible
参数：

locator
timeout=None
error=None

说明：

等待直到定位器标识的元素不可见。

如果超时在该元素不可见之前到期则失败。有关使用超时及其默认值的更多信息，请参见超时''部分;有关定位器语法的详细信息，请参见定位元素’'部分。

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

167 Wait Until Element Is Visible
参数：

locator
timeout=None
error=None

说明：

等待直到定位器标识的元素可见。

如果超时在元素可见之前失效。有关使用超时及其默认值的更多信息，请参见超时''部分;有关定位器语法的详细信息，请参见定位元素’'部分。

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

168 Wait Until Location Contains
参数：

expected
timeout=None
message=None

说明：

等待直到当前URL包含预期的URL。

预期参数包含url中的期望值。

如果超时在该位置包含之前过期，则失败。有关使用超时及其默认值的更多信息，请参见超时部分。

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

SeleniumLibrary 4.0的新功能。

169 Wait Until Location Does Not Contain
参数：

location
timeout=None
message=None

说明：

等待直到当前URL不包含location参数标识的内容。

位置参数包含网址中不应包含的值。

如果超时在该位置不包含之前到期，则失败。有关使用超时及其默认值的更多信息，请参见超时部分。

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

SeleniumLibrary 4.3的新功能。

170 Wait Until Location Is
参数：

expected
timeout=None
message=None

说明：

等待直到当前URL被预期。

预期参数是url中的期望值。

如果超时在该位置之前过期则失败。有关使用超时及其默认值的更多信息，请参见超时部分。

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

SeleniumLibrary 4.0的新功能。

171 Wait Until Location Is Not
参数：

location
timeout=None
message=None

说明：

等待直到当前URL不在location。

location参数是url中的意外值。

如果超时没有在该位置之前到期，则失败。有关使用超时及其默认值的更多信息，请参见超时部分。

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

SeleniumLibrary 4.3的新功能。

172 Wait Until Page Contains
参数：

text
timeout=None
error=None

说明：

等待直到文本出现在当前页面上。

如果超时在文本出现之前失效，则失败。有关使用超时及其默认值的更多信息，请参见超时部分。

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

173 Wait Until Page Contains Element
参数：

locator
timeout=None
error=None
limit=None

说明：

等待直到元素定位符出现在当前页面上。

如果超时在元素出现之前失效，则失败。有关使用超时及其默认值的更多信息，请参见超时''部分;有关定位器语法的详细信息，请参见定位元素’'部分。

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

limit参数可用于定义页面应包含多少个元素。当limit为None时（默认）页面可以包含一个或多个元素。当limit为数字时，页面必须包含相同数量的元素。

limit参数在SeleniumLibrary 4.4中是新的。

174 Wait Until Page Does Not Contain
参数：

text
timeout=None
error=None

说明：

等待直到文本从当前页面消失。

如果超时在文本消失之前失效，则失败。有关使用超时及其默认值的更多信息，请参见超时部分。

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

175 Wait Until Page Does Not Contain Element
参数：

locator
timeout=None
error=None
limit=None

说明：

等待直到元素定位符从当前页面消失。

如果超时在元素消失之前失效，则失败。有关使用超时及其默认值的更多信息，请参见超时''部分;有关定位器语法的详细信息，请参见定位元素’'部分。

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

limit参数可用于定义页面不应该包含多少个元素。当limit为None时（默认）页面不能包含任何元素。当limit为数字时，页面不能包含相同数量的元素。

limit参数在SeleniumLibrary 4.4中是新的。

至此，我们用了十一章详细介绍了SeleniumLibrary的库，包含175个关键字，其中有三个是已经被废弃的，在SeleniumLibrary库中可用的关键字共有172个。

作者：马克社区何老师