Robotframework之Selenium2Library常用关键字总结

目录

• 1.1 BrowserManagement
• 1.2 Cookie
• 1.3 Elements
  • 1.3.1 Elements
  • 1.3.2 formElement
  • 1.3.3 SelectElement
  • 1.3.4 TableElement
• 1.4 JavaScript
• 1.5 Screenshot
• 1.6 waiting

1.1 BrowserManagement

关键字	参数	释义	备注
Open Browser	[browser/url]	打开浏览器
Switch Browser	[browser]	切换浏览器
Close Browser	null	关闭浏览器
Close All Browsers	null	关闭所有已打开浏览器
Go To	[url ]	在已打开浏览器 上打开url界面
Select Window	[ locator=locator timeout=timeout ]	根据locator选中窗口	用来处理弹窗，实际操作不能保证一次中标，最好配合Wait Until Keyword Succeeds
Wait Until Keyword Succeeds	[ retry/retry_interval /name / *args ]	运行指定的关键字，如果失败则重试
Select Window By Handle	[ locator=locator timeout=timeout ]	根据Handle选择窗口
Get Window Handles	[ url browser ]	获取所有窗口的handle	返回的是List
Get Current Window Handles	[ url browser ]	获取当前窗口的handle
Close Window	null	关闭当前打开的弹出窗口
Select Frame	[ locator=locator ]	选择frame	如果有多层frame，要从最外层依次select frame
Unelect Frame		跳出所有的frame或者iframe	会跳出到最外层

1.2 Cookie

关键字	参数	释义	备注
Add Cookie		添加cookie
Delete Cookie		删除cookie
Delete All Cookie		删除所有cookie
Get Cookies		获取所有cookie
Get Cookie Value		获取cookie的值

1.3 Elements

1.3.1 Elements

关键字	参数	释义	备注
Click Element	[ locator=locator ]	点击Element
Click Link	[ locator=locator ]	点击Link
Click Image	[ locator=locator ]	点击Image
Press Key		模拟键盘造作
Press Key\13		模拟按回车
Mouse Down	[ locator=locator ]	鼠标向下
Mouse Up	[ locator=locator ]	鼠标向上
Mouse Over	[ locator=locator ]	鼠标悬浮
Get Horizontal Position	[ locator=locator ]	获取当前对象的左上角定点距离整个页面的横坐标
Get Vertical Position	[ locator=locator ]	获取当前对象的左上角定点距离整个页面的纵坐标
Get Value	[ locator=locator ]	获取元素的value	若对象没有value会获取空值
Get Text	[ locator=locator ]	获取元素的text	若对象没有text会获取空值
Get Element Attribute	[ locator=locator ]	获取元素属性	get element attribute element_id@class 获取元素class属性

1.3.2 formElement

form就是表单。这里总结对checkbox,radio buttons,fields,对象的操作方法。
form:

关键字	参数	释义	备注
Submit Form	[ locator=locator ]	提交表单

checkbox:

关键字	参数	释义	备注
Select Checkbox	[ locator=locator ]	勾选复选框
Unselect Checkbox	[ locator=locator ]	不勾选复选框

radio buttons:

关键字	参数	释义	备注
Select Radio Button	[ ${group_name} ${value} ]	选择radio按钮

text fields:

关键字	参数	释义	备注
Chose File		上传文件的时候选择文件
input text	[ locator=locator ]	输入密码	在输出密码日志上会打印密码出来
input text	[ locator=locator ]	输入密码	在输出密码日志上不会打印密码出来

1.3.3 SelectElement

列表框分单选和多选。

关键字	参数	释义	备注
Select from List	[ locator=locator ]	选择列表框中的某一项
Select from List By Index	[ locator=locator ]	根据index选择列表框中的某一项
Select from List By Value	[ locator=locator ]	根据value选择列表框中的某一项
Select from List By Label	[ locator=locator ]	根据Label选择列表框中的某一项
Select All from List	[ locator=locator ]	选择列表框中的所有项
Unselect from List	[ locator=locator ]	取消选择列表框中的某一项
Unselect from List By Index	[ locator=locator ]	根据index取消选择列表框中的某一项
Unselect from List By Value	[ locator=locator ]	根据value取消选择列表框中的某一项
Unselect from List By Label	[ locator=locator ]	根据Label取消选择列表框中的某一项
Unselect All from List	[ locator=locator ]	取消选择列表框中的所有项
Get List Items	[ locator=locator ]	获取所有的列表项
Get Selected List Value/Values	[ locator=locator ]	获取已选中列表项的Value
Get Selected List Label/Values	[ locator=locator ]	获取已选中列表项的Label

1.3.4 TableElement

关键字	参数	释义	备注
Get Table Cell	[ ${table_locator} ${row} ${column} ${loglevel}=INFO]	获取table里某个行列里的元素的文本值	前提需要知道数据在哪行哪列
Click Element At Table Cell		点击表格指定单元格里的元素	前提需要知道数据在哪行哪列
Click Link At Table Cell		点击表格指定单元格里的链接	前提需要知道数据在哪行哪列
Get Table Rows		获取表格的行数
Get Table Cols At Row		获取某一行表格有多少列

1.4 JavaScript

关键字	参数	释义	备注
Execute JavaScript	[${code}]	执行JavaScript脚本
Execute Async JavaScript	[${code}]	执行异步 JavaScript脚本	异步 JavaScript脚本需在函数最后加上回调来返回函数结果
Confirm Action		确认Alert或者其他对话框的弹出

如果想在弹出的对话框中自动选择取消，在Confirm Action 前面加上一句“choose cancel on next confirmation ”。如果下一个要选择确认， 在Confirm Action 前面加上一句“choose ok on next confirmation。

1.5 Screenshot

关键字	参数	释义	备注
Capture Page Shoot		对当前界面进行截图

1.6 waiting

关键字	参数	释义	备注
Wait For Condition	[${locator} ${timeout}= ${error}=]	等待条件成立	显示等待
Wait Until Page Contains	[${locator} ${timeout}= ${error}=]	查页面中是否包含预期信息	显示等待
Wait Until Page Contains element	[${locator} ${timeout}= ${error}=]	等待页面包含元素	显示等待
Wait Until Keyword Succeeds	[ ${timeout} ${retry} ${keyword} @{args}]	等待成功	在BuiltIn包里。在页面加载比较慢的时候适用
Wait Until Page	[${locator} ${timeout}= ${error}=]	等待页面出现	在BuiltIn包里。在页面加载比较慢的时候适用

更多在断言相关模块进行总结。