三十二.robotframework-Selenium2Library详解

元素定位:
Selenium2Library 中的所有关键字都需要通过参数 locator 在 web 页面中进行定位。默认情况下，当
一个 locator 值是有效的，它就可以匹配不同页面元素的某些特殊属性。id 和 name 属性可以适用于所有元素，比如：
Click Element my_element
当然，并不是说只能使用 id 和 name 属性来进行定位，在 Selenium2Library 中想去查找某个页面元
素支持多种不同的方式，类型如下：

超时等待:
包含多种 wait …关键字。所有的超时等待参数都是可选的。可以将这些 wait 关键字的值设置为全
局变量，使 Selenium2Library 共用同一等待时间（参见 Set Selenium Timeout 关键字）。同样的超时
等待可以支持 Execute Async Javascript 关键字。
超时等待时间可以给定一个明确的值来定义（比如 0.5 或 42），更多的信息可以参照：
http://robotframework.googlecode.com/svn/trunk/doc/userguide/RobotFrameworkUserGuide.ht
ml#time-format

引入Selenium2Library 类库:
参数：
timeout=5.0
implicit_wait=0.0
run_on_failure=Capture Page Screenshot
描述：
Selenium2Library 可以导入可选参数。
默认的超时等待可以适用于所有的等待行为。它也可以通过 Set Selenium Timeout 来进行配置。
‘implicit_wait’ 是隐式超时。可以通过 Set Selenium Implicit Wait 进行配置。更多的隐式等待
信息请参照：http://seleniumhq.org/docs/04_webdriver_advanced.html#explicit-and-implicit-waits
当 Selenium2Library 某个关键字执行失败时将指定运行关键字 run_on_failure。
默认可以使用 Capture Page Screenshot 来截取当前页面内容。使用值 'Nothing’可以完全禁用该
功能。查看关键 Register Keyword To Run On Failure 来获得更多资料。
示例：

验证页面是否包含相应结果
Page
• Page Should（Not)Contain Button
• Page Should（Not)Contain Checkbox
• Page Should（Not)Contain Element
• Page Should（Not)Contain Image
• Page Should (Not)Contain Link
• Page Should (Not)Contain List
• Page Should（Not)Contain Radio Button
• Page Should（Not)Contain Textfield
Location & Title
• Location Should Be
• Location Should Contain
• Title Should Be
Text
• Current Frame Contains
• Page Should Contain
• Page Should Not Contain
• Textfield Value Should Be
Element
• Element Should Be Disabled
• Element Should Be Enabled
• Element Should Be Visible
• Element Should Contain
• Element Should Not Be Visible
• Element Text Should Be
List
• List Selection Should Be
• List Should Have No Selections
Checkbox
• Checkbox Should Be Selected
• Checkbox Should Not Be Selected
Radio Button
• Radio Button Should Be Set To
• Radio Button Should Not Be Selected
Table
• Table Cell Should Contain
• Table Column Should Contain
• Table Footer Should Contain
• Table Header Should Contain
• Table Row Should Contain
• Table Should Contain
• Textfield Should Contain
Xpath
• Xpath Should Match X Times

对于页面 AJAX 可以使用如下等待页面的关键词：
• Wait For Condition | condition | timeout=None | error=None
• Wait Until Page Contains | text | timeout=None | error=None
• Wait Until Page Contains Element | locator | timeout

和其他界面元素交互的关键词：
Element
• Focus 聚焦
• Simulate 模拟时间触发
• Open Context Menu 打开
List
• Select All From List
• Select From List
• Unselect From List
Checkbox
• Select Checkbox
• Unselect Checkbox
Radio Button
• Select Radio Button
Form
• Submit Form
• Choose File （For File Upload)

获取页面信息相关关键词：
Page
• Get Title
• Get Location
• Get Source
• Get Matching Xpath Count
Element
• Get Element Attribute
• Get Value
• Get Text (Added By Adam Wu)
Link
• Get All Links
Table
• Get Table Cell
List
• Get List Items
• Get Selected List Label
• Get Selected List Labels
• Get Selected List Value
• Get Selected List Values

切换窗口相关关键词：
• Get Window Identifiers
• Get Window Names
• Get Window Titles

关键字
关键字： Add Cookies
参数：
Name,value,
path=none,
domain=none,
secure=none,
expiry=none
描述：
添加一个 cookie 到你当前的 session 中。Name 和 value 变量为必输项，path、domain 和 secure 是
选输项。

关键字： Alert Should Be Present
参数：
Text=
描述：
校验是否有 alert 提示框出现。如果提示框信息不为空，则它将校验 alert 信息是否与 text 一致。

关键字： Assign Id To Element
参数：
Locator，id 描述：
分配一个临时属性给特殊标识元素。当遇到定位元素复杂/繁琐的 Xpath 表达式时该方法就徆有必要
了。 示例：

关键字： Capture Page Screenshot
参数：
Filename=None 描述：
截取当前页面并将其嵌入到日志。 Filename参数指定写入日志的截图名称。 如果该参数为空，那么截图名称将以”selenium-screenshot-.png”格式保存到RF日 志文件所在目录下。

关键字： Checkbox Should Be Selected
参数：
Locator 描述：
通过定位标识出的checkbox元素已被选择或者勾选。 Checkboxes关键字属性为id和name。

关键字： Checkbox Should Not Be Selected
参数：
Locator
描述：
通过定位标识出的checkbox元素已被选择或者勾选。 Checkboxes关键字属性为id和name。

关键字： Choose Cancel On Next Confirmation
参数：
无
描述：
系统弹出框后，点击”cancel”按钮。

关键字： Choose File
参数： Locator, file_path
描述：
在定位的输入框中输入file_path信息。 该关键字常用在上传文件中。被指定的文件的file_path必须可用。
示例：

关键字： Click Button
参数：
Locator, file_path
描述：
点击被定位按钮。 buttons关键字属性为id，name和value。

关键字： Click Element
参数： Locator, file_path
描述：
点击被定位按钮。 Element关键字属性为id，name和value。

关键字： Click Element At Coordinates
参数： Locator， Xoffset， Yoffset
描述：
通过x，y坐标点击页面元素。

关键字： Click Image
参数：
Locator
描述：
点击被定位图片。 Images关键字属性为id，src和alt。

关键字： Click Link
参数： Locator
描述：
点击被定位链接。 Links关键字属性为id，name，href和link text。

关键字： Close All Browsers
参数： 无
描述：
关闭全部打开状态的浏览器并重置缓存。 执行完该关键字后，再次打开浏览器，浏览器对应index值从 1开始计算。 关键字必须在test或者 suite的teardown时使用，为了确保所有浏览器已被关闭。

关键字： Close Browsers
参数： 无
描述：
关闭当前浏览器。

关键字： Close Window
参数： 无
描述：
关闭当前打开的弹出框。

关键字： Confirm Action
参数࿱