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个。
