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

关键字
SeleniumLibrary4.5.0的关键字一共有175个,下面我们一个一个来看:

1 Add Cookie
添加cookie

参数:

name
value
path=None
domain=None
secure=None
expiry=None

说明:

将cookie添加到当前会话。

名称和值是必需的,路径,域,安全性和有效期是可选的。 Expiry支持与DateTime库或纪元时间戳相同的格式。

Example:

Add Cookie foo bar
Add Cookie foo bar domain=example.com
Add Cookie foo bar expiry=2027-09-28 16:21:35 # Expiry 作为时间戳.
Add Cookie foo bar expiry=1822137695 # Expiry作为时期秒.
注意:

在SeleniumLibrary 3.0之前的版本,expiry设置无效.

2 Add Location Strategy
添加定位策略

参数:

strategy_name
strategy_keyword
persist=False

说明:

添加自定义位置策略。

有关如何创建和使用自定义策略的信息,请参阅“自定义定位器”。 删除位置策略可用于删除已注册的策略。

默认情况下,位置策略在离开当前范围后会自动删除。 将persist设置为真值(请参阅布尔参数)将使定位策略在测试的整个生命周期内保持注册状态。

3 Alert Should Be Present
警报应该存在

参数:

text=
action=ACCEPT
timeout=None

说明:

验证是否存在警报,并且默认情况下接受警报。

如果没有警报,则失败。如果文本是非空字符串,则用于验证警报消息。默认情况下会接受警报,但是可以通过使用与操作警报相同的操作参数来控制行为。

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

注意:

action和timeout参数是SeleniumLibrary 3.0中的新增功能。在早期版本中,警报始终被接受,并且超时被硬编码为一秒。

4 Alert Should Not Be Present
警报不应该存在

参数:

action=ACCEPT
timeout=0

说明:

验证没有警报存在。

如果警报确实存在,则action参数确定应如何处理它。默认情况下,警报被接受,但是也可以使用与“处理警报”关键字相同的方式将其关闭或打开。

超时指定等待警报显示多长时间。默认情况下,根本不等待警报,但是如果警报可能延迟,则可以指定自定义时间。有关语法的信息,请参见时间格式部分。

注意:

SeleniumLibrary 3.0中的新功能。

5 Assign Id To Element
将id分配给元素

参数:

locator
id

说明:

为定位器指定的元素分配一个临时ID。

如果定位器是复杂的和/或XPath表达式较慢并且需要多次,则这主要有用。重新加载页面时,标识符会过期。

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

例子:

Assign ID to Element //ul[@class=‘example’ and ./li[contains(., ‘Stuff’)]] my id
Page Should Contain Element my id
.上述例子中将一个复杂的xpath定位的元素用my id来表示,这样页面就包含了my id 这个元素。



作者:马克社区何老师