三十二.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
参数： Locator, file_path
描述：
接触当前显示confirm对话框并返回它的message 信息。 默认情况下，该关键字选择对话框中的“OK”项。如果需要选择“Cancel”项，请在该关键字执行 前调用“Choose Cancel On Next Confirmation”，以免对话框已关闭。
示例：

关键字： Current Frame Contains
参数： Text, loglevel=info
描述：
指定当前frame下的text。 可以查看“Page Should Contain”关于loglevel参数的解释。

关键字： Current Frame Should Not Contain
参数： Text, loglevel=info
描述：
指定当前frame下的text。 可以查看“Page Should Contain”关于loglevel参数的解释。

关键字： Create Webdriver
参数：

driver_name,
alias=None,
kwargs={},
**i nit_kwargs
描述：
WebDriver创建一个实例。
类似Open Browser关键字,但允许WebDriver的__init__传递参数。Open Browser关键字是在可行的情况下首选创建Webdriver。
执行关键字实例化后会返回这个浏览器索引的方便后续使用,方便使用索引值进行切换。 索引从1开始,重 置索引时需要关闭所有浏览器再使用该关键字。
DRIVER_NAME必须是selenium.webdriver调用webdriver正确的名称。 WebDriver名称包括:Firefox、 Chrome,Opera,Safari,PhantomJS和Remote。
使用该关键字参数来指定你想要的参数传给WebDriver的__init__。 未以任何方式处理的参数值传递之前。Robot Framework< 2.8,不支持关键字参数,创建一个关键字字典和作为参数传递kwargs。 看到 Selenium API Documentation
示例：

2.8版本示例

关键字： Delete All Cookies
参数： 无
描述：
删除所有cookies信息。

关键字： Delete Cookies
参数： Name
描述：
删除不参数name匹配的cookies信息。 当未匹配到对应name 的cookies信息，则不执行。

关键字： Double Click Element
参数： Locator
描述：
双击被定位的element元素。 属性为id和name。

关键字： Drag And Drop
参数： source, target
描述：
拖拽被定位element资源。 Element可被移动到其他目标参数之上。 目标为一个元素定位器，可以将对象拖拽并放下。
示例：

关键字： Drag And Drop By Offset
参数： Source, xoffset, yoffset
描述：
按照坐标拖拽。
示例：

关键字： Element Should Be Disabled
参数： Locator
描述：
指定element元素不可见。 指定属性为id和name。

关键字： Element Should (Not) Be Enable
参数： Locator
描述：
指定element元素(不)可用。 指定属性为id和name。

关键字： Element Should Be Visible
参数： Locator, Message=
描述：
指定element元素可见。 于此，可见的意思是逻辑可见，而非视觉可见。 比如：一个element元素的display属性为none，这个是逻辑不可见，所以使用这个关键字后，针 对该元素的操作将失败。

关键字： Element Should Contain
参数： Locator, Expected, Message=
描述：
指定的element元素必须包含期望text内容。 如果你希望校验一个准确匹配（非模糊匹配）的Text信息，可以使用该关键字。 Message 可以用来覆盖缺省的报错信息。
关键字： Element Text Should Be
参数： Locator, Expected, Message=
描述：
通过定位器指定element必须准确包含预期text内容。 不“element should contain”比较，该关键字仅支持精确匹配，不支持模糊字符串匹配。

关键字： Execute Async Javascript
参数： *code
描述：
执行异步java脚本代码。 代码可以包含多行代码但是必须包含返回信息。 代码可以在测试数据中被分割为多个单元。即便如此，彼此关联的组件间不允许任意增加空间。 如果被执行代码的路径为绝对路径，那么javascript将从这个绝对路径文件中读取并运行。
示例：

关键字： Execute Javascript
参数： *code
描述：
执行java脚本代码。 代码可以包含多行代码但是必须包含返回信息。 代码可以在测试数据中被分割为多个单元。即便如此，彼此关联的组件间不允许任意增加空间。 如果被执行代码的路径为绝对路径，那么javascript将从这个绝对路径文件中读取并运行。
示例：

关键字： Focus
参数： Locator
描述：
设置定位器定位元素为焦点目标。

关键字： Frame Should Contain
参数： Locator, Text, Loglevel=info
描述：
指定的frame必须包含期望text内容。 Loglevel参数的使用可以见“Page Should Contain”的解释。

关键字： Get Alert Message
参数： 无
描述：
返回当前js alert窗口的text信息。 如果不存在alert窗口则执行该关键字失败。 注意，后续关键字将运行失败，除非通过此关键或者其他关键字，比如Get Alert Message，将 alert 窗口关闭。

关键字： Get All Links
参数： 无
描述：
返回当前页面的所有link类型的对象，并存入list

关键字： Get Cookie Value
参数： Name
描述：
通过name查找对应cookie的值，并返回。 如果cookie 不存在，则关键字执行失败。

关键字： Get Element Attribute
参数： Attribute_locator
描述：
返回element属性值。 属性定位器attribute_locator由标记@和属性名称组成，比如“element_id@class”

关键字： Get Horizontal Position
参数： Locator
描述：
返回定位element元素的水平位置。 位置为整型类型，从屏幕左上角算起。 请参阅：Get Vertical Position

关键字： Get List Items
参数： Locator
描述：
从已定位list对象中返回该list下的所有item项。 用于关键字所选中列表的Lists和combo boxes的元素。使用选择关键属性是ID和名称，定位列表 中内容。 请参阅有关本文介绍的元素定位内容。

关键字： Get location
参数：
无
描述：
返回当前位置信息

关键字： Get Matching Xpath Count
参数：
无
描述：
返回匹配xpath格式的元素数量。 如果你想对元素匹配进行断言，请使用xpath Should Match X Times。

关键字： Get Selected List Lable
参数：
Locator
描述：
返回定位器定位的list下的被选元素的标签信息。 Select list关键字可以在lists和combo boxes二者使用。它的关键字属性为id和name。

关键字： Get Selected List Value
参数：
Locator
描述：
返回定位器定位的list下的被选元素的value值。 Select list关键字可以在lists和combo boxes二者使用。它的关键字属性为id和name。

关键字： Get Selected List Values
参数：
Locator
描述：
返回定位器定位的list下的被选元素的value值(以list形式保存)。 如果没有选项则关键字执行失败。 elect list关键字可以在lists和combo boxes二者使用。它的关键字属性为id和name。

关键字： Get Selenium Implicit Wait
参数：
无
描述：
设置selenium隐式等待时间。 Selenium默认等待30秒。
该关键字解释说明请看Set Selenium Implicit Wait 关键字。

关键字： Get Selenium Speed
参数：
无
描述：
获取执行每一条selenium命令时的延迟时间。
该关键字解释说明请看Set Selenium Speed 关键字。

关键字： Get Selenium Timeout
参数：
无
描述：
获取该关键执行之前使用过的各类关键字的timeout时间。
该关键字解释说明请看Set Selenium Timeout 关键字。

关键字： Get Source
参数：
无
描述：
获取当前页面全部html源。

关键字： Get Table Cell
参数：
Table_locator, Row, Column, Loglevel=info
描述：
返回指定表格单元的内容。 行和列起始从1开始。 头尾行包含在count里。这就意味着表头和表尾也可以通过该关键字获取。
详见Page Should Contain 关键字有关日志级别参数的解释。

关键字： Get Text
参数：
locator,
描述：
返回定位器定位元素的text值。 请参阅有关本文介绍的元素定位内容。

关键字： Get Title
参数：
locator,
描述：
返回当前页面title属性值。

关键字： Get Value
参数：
locator,
描述：
返回当前定位器定位元素value属性值。 请参阅有关本文介绍的元素定位内容。

关键字： Get Vertical Position
参数：
locator,
描述：
返回定位element元素的垂直位置。
请参阅Get Horizontal Position 关键字

关键字： Get Window Names
参数：
无
描述：
返回并记录将所有可识别windows的名字。

关键字： Get Window Size
参数：
无
描述：
返回当前window界面的尺寸，先宽度后高度。
示例：

关键字： Get Window Size
参数：
无
描述：
返回并记录将所有可识别windows的标题。

关键字： Go Back
参数：
无
描述：
模拟用户点击浏览器界面的“后退”按钮。

关键字： Go To
参数：
Url
描述：
使当前激活浏览器页面跳转至用户所提供的url地址。

关键字： Input Password
参数：
Locator, Text
描述：
将已给出密码项输入到定位文本域中。 不“Input Text”的区别再于该关键字无法记录所给的密码信息。

关键字： Input Text
参数：
Locator, Text
描述：
将给出的文本内容输入到定位文本域中。请参阅有关本文介绍的元素定位内容。

关键字： List Selection Should Be
参数：
Locator, items
描述：
验证被选list控件中的selection项是否不参数items匹配。 如果你希望测试空选项的情况，通常情况下无需给出items值。 该关键字同时可以在lists和combo boxes中使用，常用属性为id和name。 请参阅有关本文介绍的元素定位内容。

关键字： List Should Hava No Selections
参数：
Locator
描述：
验证被选list控件中的selection项是否未选择。 该关键字同时可以在lists和combo boxes中使用，常用属性为id和name。 请参阅有关本文介绍的元素定位内容。

关键字： Location Should Be
参数：
Url
描述：
校验当前URL地址是否不所给url地址一致。

关键字： Location Should Contain
参数：
Expected
描述：
校验当前URL地址是否包含预期值。

关键字： Log Location
参数：
无
描述：
记录并返回当前位置。

关键字： Locator Should Match X Times
参数：
locator, expected_locator_count, message=, loglevel=INFO
描述：
验证该页面包含位于由给出定位器元件的给定数量。 请参阅有关本文介绍的元素定位内容。
详见Page Should Contain Element 关键字有关日志级别参数的解释。

关键字： Log Location
参数：
无
描述：
记录并返回当前位置。

关键字： Log Source
参数：
Loglevel=INFO
描述：
记录并返回当前页面或者frame框内的全部html资源。 该loglevel参数定义了使用的日志级别。有效的日志级别是WARN, INFO (默认项), DEBUG, and NONE (无日志记录).

关键字： Log Title
参数：
无
描述：
记录并返回当前页面title 值。

关键字： Maximize Browser Window
参数：
无
描述：
将当前浏览器最大化。

关键字： Mouse Down
参数：
locator
描述：
模拟用户进行鼠标左键操作。 进行点击操作但不释放。 关键字属性为id和name。 请参阅有关本文介绍的元素定位内容。
请参阅关键字Mouse Down On Image 和 Mouse Down On Link 数的解释。

关键字： Mouse Down On Image
参数：
locator
描述：
模拟鼠标点击image事件。 定位使用Image元素的id, src 和 alt属性。 请参阅有关本文介绍的元素定位内容。

关键字： Mouse Down On Link
参数：
locator
描述：
模拟鼠标点击Link事件。 定位使用Link元素id, name, href 和 link text属性。 请参阅有关本文介绍的元素定位内容。

关键字： Mouse Out
参数：
locator
描述：
模拟将鼠标指针从定位元素上移开事件。 定位使用Element元素的ID和Name属性。
请参阅有关本文介绍的元素定位内容。

关键字： Mouse Over
参数：
locator
描述：
模拟鼠标悬停动作。 定位使用Element元素的ID和Name属性。 请参阅有关本文介绍的元素定位内容。

关键字： Mouse Up
参数：
locator
描述：
模拟释放鼠标左键动作。 定位使用Element元素的ID和Name属性。 请参阅有关本文介绍的元素定位内容。

关键字： Open Browser
参数：
Url, Browser=firefox, Alias=none,
Remote_url=false, Desired_capabilities=none, Ff_profile_dir=none
描述：
打开一个新的browser，并转至所给url地址。 返回新打开browser的index值，该值可以在之后的操作进行browser切换操作。Index值从1开 始，当执行了close all browsers 关键字后，资源释放。 可选参数alias是浏览器实例的别名，它能够在浏览器间切换时使用（类似于index），可以查看关 键字“Switch Browser”获得更多细节。 必填参数Browser有如下值可以使用：

可选的’remote_url“URL是selenium进程服务器地址例如“http://127.0.0.1/wd/hub”。如果用于remote 指定一个值，还可以指定’desired_capabilities’，这是一个字符串的形式KEY1：val1中，KEY2： val2中，将用于指定desired_capabilities 到进程服务器。这是做这样的事情指定代理服务器的Internet Explorer或如果您使用saucelabs.com指定浏览器和操作系统是非常有用。 'desired_capabilities’也可 以是一个Python的dictonary（字典）），以允许更复杂的配置。

关键字： Open Context Menu
参数：
Locator
描述：
打开上下文菜单。
关键字： Page Should (Not) Contain
参数：
Text, Loglevel=info
描述：
验证当前页面(不)包含“text”信息。 如果该关键字失败，它将自动的使用loglevel记录这个页面资源。 不给出loglevel参数，将无法记录日志。 该loglevel参数定义了使用的日志级别。有效的日志级别是WARN, INFO (默认项), DEBUG, and NONE (无日志记录).

关键字： Page Should (Not) Contain Button
参数：
Locator, Message=, Loglevel=info
描述：
验证当前页面(不)包含某button。 该关键字所查找的buttons一般情况下是由input或者button tag提供的。 定位使用Buutons元素的ID,Name和Value属性。 请参阅有关本文介绍的元素定位内容。 该loglevel参数定义了使用的日志级别。有效的日志级别是WARN, INFO (默认项), DEBUG, and NONE (无日志记录).

关键字： Page Should (Not) Contain Checkbox
参数：
Locator, Message=, Loglevel=info
描述：
验证当前页面(不)包含某Checkbox。 定位使用Checkbox元素ID和Name属性 请参阅有关本文介绍的元素定位内容。 该loglevel参数定义了使用的日志级别。有效的日志级别是WARN, INFO (默认项), DEBUG, and NONE (无日志记录).

关键字： Page Should (Not) Contain Element
参数：
Locator, Message=, Loglevel=info
描述：
验证当前页面(不)包含某Element。 定位使用Element元素ID和Name属性 请参阅有关本文介绍的元素定位内容。 该loglevel参数定义了使用的日志级别。有效的日志级别是WARN, INFO (默认项), DEBUG, and NONE (无日志记录).

关键字： Page Should (Not) Contain Image
参数：
Locator, Message=, Loglevel=info
描述：
验证当前页面(不)包含某Image。 定位使用Image元素ID,alt和src属性 请参阅有关本文介绍的元素定位内容。 该loglevel参数定义了使用的日志级别。有效的日志级别是WARN, INFO (默认项), DEBUG, and NONE (无日志记录).

关键字： Page Should (Not) Contain List
参数：
Locator, Message=, Loglevel=info
描述：
验证当前页面(不)包含某List。 定位使用List元素ID和Name 属性 请参阅有关本文介绍的元素定位内容。 该loglevel参数定义了使用的日志级别。有效的日志级别是WARN, INFO (默认项), DEBUG, and NONE (无日志记录).

关键字： Page Should (Not) Contain Radio Button
参数：
Locator, Message=, Loglevel=info
描述：
验证当前页面(不)包含某Radio Button。 定位使用Radio Button元素ID，Value和Name属性
请参阅有关本文介绍的元素定位内容。 该loglevel参数定义了使用的日志级别。有效的日志级别是WARN, INFO (默认项), DEBUG, and NONE (无日志记录).

关键字： Page Should (Not) Contain TextField
参数：
Locator, Message=, Loglevel=info
描述：
验证当前页面(不)包含某TextField。 定位使用Radio Button元素ID和Name属性 请参阅有关本文介绍的元素定位内容。 该loglevel参数定义了使用的日志级别。有效的日志级别是WARN, INFO (默认项), DEBUG, and NONE (无日志记录).

关键字： Press Key
参数：
Locator, Key， Wait=
描述：
模拟用户键盘操作。
Key 既可以是单个字符，也可以是ASCII 码，但是需要在前加入’\’。
请参阅有关本文介绍的元素定位内容。
有时，这种关键字不会触发点击元素的正确JavaScript事件。在这种情况下， Press Key
Native 可以作为一种解决方法。
示例：

这里的’\13’对应ASCII 码的回车键。
ASSCII码列表：
NULL =’\ue000’
CANCEL =’\ue001’# ^break
HELP=’\ue002’
BACKSPACE =’\ue003’
BACK_SPACE =BACKSPACE
TAB =’\ue004’
CLEAR =’\ue005’
RETURN =’\ue006’
ENTER =’\ue007’
SHIFT =’\ue008’
LEFT_SHIFT =SHIFT
CONTROL =’\ue009’
LEFT_CONTROL =CONTROL
ALT =’\ue00a’
LEFT_ALT =ALT
PAUSE =’\ue00b’
ESCAPE =’\ue00c’
SPACE =’\ue00d’
PAGE_UP =’\ue00e’
PAGE_DOWN =’\ue00f’
END =’\ue010’
HOME =’\ue011’
LEFT =’\ue012’
ARROW_LEFT =LEFT
UP =’\ue013’
ARROW_UP =UP
RIGHT =’\ue014’
ARROW_RIGHT =RIGHT
DOWN =’\ue015’
ARROW_DOWN =DOWN
INSERT =’\ue016’
DELETE =’\ue017’
SEMICOLON =’\ue018’
EQUALS =’\ue019’
NUMPAD0 =’\ue01a’# number pad keys
NUMPAD1 =’\ue01b’
NUMPAD2 =’\ue01c’
NUMPAD3 =’\ue01d’
NUMPAD4 =’\ue01e’
NUMPAD5 =’\ue01f’
NUMPAD6 =’\ue020’
NUMPAD7 =’\ue021’
NUMPAD8 =’\ue022’
NUMPAD9 =’\ue023’
MULTIPLY =’\ue024’
ADD =’\ue025’
SEPARATOR =’\ue026’
SUBTRACT =’\ue027’
DECIMAL =’\ue028’
DIVIDE =’\ue029’
F1 =’\ue031’# function keys
F2 =’\ue032’
F3 =’\ue033’
F4 =’\ue034’
F5 =’\ue035’
F6 =’\ue036’
F7 =’\ue037’
F8 =’\ue038’
F9 =’\ue039’
F10 =’\ue03a’
F11 =’\ue03b’
F12 =’\ue03c’
META =’\ue03d’
COMMAND =’\ue03d’

关键字： Press Key Native
参数：
Keycode Wait=
描述：
用户通过发送模拟按钮操作系统按键。 KeyCode 对应java.awt.event.keyevent常量，可以到寺找： http://java.sun.com/javase/6/docs/api/constant-values.html#java.awt.event.KeyEvent.CHAR _UNDEFINED 按钮不针对特定元素，一个元素可以通过Focus关键字定位为第焦点 请参阅有关本文介绍的元素定位内容。
示例：

注意这个关键字是非常脆弱的，例如，使用键盘或鼠标在测试运行时经常引起问题。可以将窗口前再 前执行Javascript。

关键字： Press Key Native Radio Button Should (Not) Be Set to
参数：
Group_name, Value
描述：
在radiobutton组里查证指定组名的选项已(未)被选定。 可以查看“Select Radio Button”获取细节。

关键字： Register Keyword To Run On Failure
参数：
Keyword
描述：
当Selenium2Library 类库关键字执行失败时，自动执行事先设置好的其他的关键字。 Keyword_name 就是关键字名称（从任何可用库中获得）。如果Selenium2Library 关键字执行失 败的情况下它是无法使用的该关键字需要添加参数。使用参数值“Noting”将其完全禁用此功能。 最初的关键字的使用设置Importing，那就是默认使用的关键字是捕获页面截图。以某事时，未能屏 幕画面是一种非常有用的功能，但是请注意，该关键字会降低脚本执行速度。

关键字： Reload Page
参数：
无
描述：
模拟页面重载。

关键字： Select All From List
参数：
Locator
描述：
选取所有复选列表的值。 定位元素使用ID和Name 属性 请参阅有关本文介绍的元素定位内容。

关键字： Select Checkbox
参数：
Locator
描述：
选择对应checkbox对象。当对象已选则不触发该动作。 定位元素使用ID和Name 属性 请参阅有关本文介绍的元素定位内容。

关键字： Select All Frame
参数：
Locator
描述：
设为某frame为当前frame。
定位使用Frames元素ID和Name属性 请参阅有关本文介绍的元素定位内容。

关键字： Select From List
参数：
Locator， items
描述：
从指定list对象中选取items项。 如果给定参数为多个选项，但是对应页面的为单选列表，那么该关键字默认选在最后一项 item。 如果目标list是多选列表，并且给定items参数为空，则所有选项均被选取。 *items会先使用value值定位选择目标，次之使用label值。 该关键字比使用’by index/value/label’方法执行快。 当单选列表中最后一项不存在或者所有选项不存在时，该关键报错。 当复选列表中如果不存在选项值或者所有值均不存在时，也将报错。

关键字： Select From List List By Index
参数：
Locator， *indexes
描述：
通过index属性定位选择列表项。该关键字可对操作Lists和Combo boxes元素。定位元素使用ID 和Name属性。请参阅有关本文介绍的元素定位内容。

关键字： Select From List List By Label
参数：
Locator， *Labels
描述：
通过Labels定位选择列表项。该关键字可对操作Lists和Combo boxes元素。定位元素使用ID和 Name属性。请参阅有关本文介绍的元素定位内容。

关键字： Select From List List By Value
参数：
Locator， *Values
描述：
通过Value定位选择列表项。该关键字可对操作Lists和Combo boxes元素。定位元素使用ID和 Name属性。请参阅有关本文介绍的元素定位内容。

关键字： Select Radio Button
参数：
Group_name， Value
描述：
被选radio button的定位方式通过以下两个参数： 1. group_name 用来存放radio input的名称； 2. Value用来存放value属性值或者id属性值；
Xpath 用来定位正确的radio button，大致如此：//input[@type=’radio’and @name=’group_name’and(@value=’value’or @id=’value’)]
示例：

关键字： Select Window
参数：
Locator=none
描述：
选取窗口。 如果窗口找到，那么所有之后使用的命令均作用于该窗口，知道该关键字再次使用。 如果未找到窗口，该关键字执行失败。 默认情况下，当提供locator的值，它将不window的title和window的javascript的名称进行匹 配。 当打开多个windows窗口时，如果查询条件一致，那么默认选择第一个。 特殊一些的情况有main(default)，它将被使用在定位主窗口时。 当然Selenium2Library 也提供一些特殊的窗口定位目录：

示例：

关键字： Set browser implicit wait
参数：
Seconds
描述：
设置当前浏览器隐式等待时间。 Selenium2中设置超时隐式等待元素，当元素发现后完成等待。这种方法只需要每次Session调用 一次。
示例：

关键字： Set Selenium implicit wait
参数：
Seconds
描述：
设置seleniu2的默认隐式等待时间，设置所有打开浏览器的隐式等待时间。 Selenium2中设置超时隐式等待元素，当元素发现后完成等待。这种方法只需要每次Session调用 一次。
示例：

关键字： Set Selenium speed
参数：
Seconds
描述：
设置每一条selenium命令执行的等待延迟时间。
该关键字徆适合减慢测试脚本执行速度，这样做可以浏览执行过程。 Seconds参数可以用RF 的time格式。 返回值为上一个speed的值。
示例：

关键字： Set Selenium Timeout
参数：
Seconds
描述：
设置当前某步骤执行前进行的超时等待时间。 请阅读本文片首部分“超时等待”内容。
示例：

关键字： Set Window Size
参数：
Width， height
描述：
设置当前窗口的高度和宽度。
示例：

关键字： Simulate
参数：
Locator, Event
描述：
模拟定位器定位元素事件。如果执行OnEvent处理程序操作元素，可以使用该关键字。 请参阅有关本文介绍的元素定位内容。

关键字： Switch Browser
参数：
Index_or_alias
描述：
通过index或alias在所有运行状态下的browser进行切换选择。 Index可以通过open browser 返回获取，alias由用户提供。
示例：

以上例子，希望没有其他浏览器打开时它第一使用Index”1”切换时浏览器。如果你不确定，你可 以将Index赋值给一个变量，如下：

关键字： Table cell should contain
参数：
Table_locator, Row, Column, Expected, Loglevel =INFO
描述：
校验某单元格中是否包含期望值信息。 行数和列数从1开始计算。 当指定单元格中包含的内容和给定内容一致时，该关键字执行通过。 当你希望测试某单元格内容准确匹配，或者比如通过某些文本内容开头，那么你可以使用 get table cell关键字并结合一些其他内嵌关键字使用，例如should be equal/should start with等。 对于Table的定位，请参阅有关本文介绍的元素定位内容。 可以查看“Page Should Contain”关于loglevel参数的解释。

关键字： Table Column should contain
参数：
Table_locator, Col, Expected, Loglevel=INFO
描述：
校验指定列是否包含预期值。 最左边列计数1起始，-1指定从尾行最后一排起始； 如果表格的单元格存在跨列组合的情况，这些组合元素将按照单列进行计算。比如有这样一个表格， 当某一行是由列A和列B合并而成的，它的物理colspan为2，但是逻辑第三列包含“C”。
示例：

对于Table的定位，请参阅有关本文介绍的元素定位内容。 可以查看“Page Should Contain”关于loglevel参数的解释。

关键字： Table Footer should contain
参数：
Table_locator, Expected, Loglevel=INFO
描述：
校验表格的footer包含预期值。 Footer的意思可以解释为任何元素，该元素是的子元素。 如果希望了解tables是如何识别的，请在introduction中查询。 对于Table的定位，请参阅有关本文介绍的元素定位内容。 可以查看“Page Should Contain”关于loglevel参数的解释。

关键字： Table Header should contain
参数：
Table_locator, Expected, Loglevel=INFO
描述：
校验表格的header，任何…元素包含预期值。 对于Table的定位，请参阅有关本文介绍的元素定位内容。 可以查看“Page Should Contain”关于loglevel参数的解释。

关键字： Table Row should contain
参数：
Table_locator, Row Expected, Loglevel=INFO
描述：
校验指定行是否包含预期值。 从最上面一列计数1起始，-1指定从尾部最后一列起始； 如果表格的结构包含thead,tbody 和tfoot庞大，最好从tbody部分开始搜索；
请阅读Table Header Should Contain 或Table Footer Should Contain
来验证表格的Header或Footer内容。 如果表格的单元格存在跨列组合的情况，这些组合元素将按照单列进行计算。比如有这样一个表格， 当某一行是由列A和列B合并而成的，它的物理colspan为2，但是逻辑第三列包含“C”。

关键字： Table should Contain
参数：
Table_locator, Expected, Loglevel=INFO
描述：
校验在表格某个位置中可以找到期望值。 对于Table的定位，请参阅有关本文介绍的元素定位内容。
可以查看“Page Should Element”关于loglevel参数的解释。

关键字： Textarea Should Contain
参数：
Locator, Expected, Message=
描述：
验证指定文本输入域中存在期望值。 Message 参数可以覆盖默认报错信息。 该关键字使用id和name 属性定位文本域。

关键字： Textarea value should be
参数：
Locator, Expected, Message=
描述：
验证指定文本输入域的值不期望值准确匹配。 Message 参数可以覆盖默认报错信息。 该关键字使用id和name 属性定位文本域。

关键字： Textfield should contain
参数：
Locator, Expected, Message=
描述：
校验文本输入框中存在期望值。 Message 参数可以覆盖默认报错信息。 该关键字使用id和name 属性定位文本域。

关键字： Textfield Value Should be
参数：
Locator, Expected, Message=
描述：
验证指定文本输入框的值不期望值准确匹配。 Message 参数可以覆盖默认报错信息。 该关键字使用id和name 属性定位文本域。

关键字： Title should be
参数：
Title
描述：
校验当前页面title值不期望值一致。

关键字： Unselect checkbox
参数：
Locator
描述：
移除checkbox选取状态。 当checkbox未被选取时，此关键字无效。 该关键字使用id和name 属性定位checkbox 请参阅有关本文介绍的元素定位内容。

关键字： Unselect Frame
参数：
Locator
描述：
将最前端frame设置为当前操作frame。

关键字： Unselect From List
参数：
Locator, *items
描述：
移除指定select 下的给定值的被选状态。
特别，当list参数为空时，将默认移除所有被选项。 *items 通过value和label移除选项。 当使用’by index/value/label’方法将更快执行。 该关键字同样适用于lists和combo boxes。 使用id和name定位select lists,请参阅有关本文介绍的元素定位内容。

关键字： Unselect From List By Index
参数：
Locator, *indexs
描述：
用途同“unselect from list”,通过index值确定list项。 该关键字同样适用于lists和combo boxes。 使用id和name定位select lists,请参阅有关本文介绍的元素定位内容。

关键字： Unselect From List By Label
参数：
Locator, *Labels
描述：
用途同“unselect from list”,通过label值确定list项。 该关键字同样适用于lists和combo boxes。 使用id和name定位select lists,请参阅有关本文介绍的元素定位内容。

关键字： Unselect From List By Value
参数：
Locator, *Values
描述：
用途同“unselect from list”,通过Value值确定list项。 该关键字同样适用于lists和combo boxes。 使用id和name 定位select lists,请参阅有关本文介绍的元素定位内容。

关键字： Wait for condition
参数：
Condition, Timeout=none, Error=none
描述：
等待给出条件为真或者超时。 代码可以包含多行，但是必须包含返回诧句。 条件可以是各种javascript表达式但是必须包含返回诧句。 Error可以用来覆盖默认报错信息。
可查看介绍来了解更多关于timeout和其默认值的内容。
类似关键字还有Wait until page contains，Wait until page contains
element，Wait until element is visible 和BuiltIn库的Wait Until
Keyword Succeeds。

关键字： Wait Until Element Is Visible
参数：
Locator, Timeout=none, Error=none
描述：
等待页面中指定元素可见,等待超时执行失败。 Error可以用来覆盖默认报错信息。
类似关键字还有Wait until page contains，Wait until page contains
element，Wait until element is visible 和BuiltIn库的Wait Until
Keyword Succeeds。

关键字： Wait Until Page Contains
参数：
Locator, Timeout=none, Error=none
描述：
等待当前页面中指定text文本内容出现。 等待超时执行失败。 Error可以用来覆盖默认报错信息。
类似关键字还有Wait until page contains，Wait until page contains
element，Wait until element is visible 和BuiltIn库的Wait Until
Keyword Succeeds。
关键字： Wait Until Page Contains Element
参数：
Locator, Timeout=none, Error=none
描述：
等待当前页面中某指定元素出现。 等待超时执行失败。 Error可以用来覆盖默认报错信息。
类似关键字还有Wait until page contains，Wait until page contains
element，Wait until element is visible 和BuiltIn库的Wait Until
Keyword Succeeds。

关键字： Xpath Should Match X Times
参数：
Xpath, Expected_xpath_count, Message=, Loglevel=INFO
描述：
验证页面包含指定的Xpath元素不Expected_xpath_count给定的数量是否一致。 Message 可以设置输出信息。
可以查阅“Page Should Contains Element”关键字关于loglevel参数的内容。