今天,我们将列举robotframework中常用的关键字
一:浏览器和窗口相关的关键字
关键字名称 | 关键字说明 |
open browser | 打开浏览器 |
close browser | 关闭浏览器 |
close all browsers | 关闭所有浏览器 |
maximize browser window | 当前浏览器窗口最大化 |
set window size | 设置浏览器的宽度和高度 |
get window size | 获取当前窗口的大小 |
set window size | 设置当前窗口的大小 |
get window handles | 获取浏览器中,全部窗口的句柄 |
switch window | 切换窗口 |
get window names | 获取浏览器,全部窗口的名称 |
get window titles get title | 获取全部窗口的标题 获取当前浏览器窗口的标题 |
get locations | 获取全部窗口的url |
二:通用操作关键字
关键字名称 | 关键字说明 |
click element | 点击元素 |
click button | 单击按钮 |
double click element | 双击元素 |
click link | 单击链接 |
input text | 在元素中输入文本值 |
get element attribute | 获取元素属性的值 |
get value | 获取元素的value值 |
get text | 获取元素的文本值 |
clear element text | 清除元素的文本值 |
get webelement | 获取一个元素对象 |
get webelements | 获取匹配的全部元素对象 |
set focus to element | 元素获取焦点 |
scroll element into view | 滚动元素到可见区域 |
drag and drop | 将一个元素拖拽到另外一个元素中 |
press keys | 模拟键盘按键操作 |
mouse over | 鼠标悬浮在元素上 |
mouse down | 模拟按下鼠标的鼠标左键 |
mouse up | 释放按下的鼠标左键 |
mouse out | 模拟鼠标离开页面上的 一个元素的操作 |
handle alert | 关闭alert弹框 |
input text into alert | 输入文本到alert弹框中,并关闭alert弹出框 |
choose file | 在上传文件的输入框中 (input元素的type为file)输入文本地址 |
三:iframe操作
web页面之间经常会采用iframe来内嵌,如果需要定位iframe中的元素,则需要先切换到对应的iframe中
select frame | //iframe[@name="books"] |
通过iframe的id、name或xpath切换到指定的iframe中,如果需要定位的iframe在当前frame内,可以直接使用select frame关键字来切换
unselect frame |
如果需要定位的iframe在当前frame外或是平级,可以先使用unselect frame设置最外层的iframe为当前frame,再使用select frame切换到指定的iframe中来定位元素
四:元素等待操作
关键字名称 | 关键字说明 |
wait until element is visible | 等待指定的元素可见 |
wait until element is not visible | 等待指定的元素不可见 |
wait until element is enabled | 等待指定的元素可用 |
wait until element contains | 等待指定的元素 包含 指定的文本内容 |
wait until element does not contain | 等待指定的元素 不包含 指定的文本内容 |
wait until page contains element | 等待页面 包含指定的元素 |
wait until page does not contains element | 等待页面 不包含指定的元素 |
wait until page contains | 等待页面 包含指定的文本内容 |
wait until page does not contain | 等待页面 不包含指定的文本内容 |
关键字中包含wait的,timeout参数默认为5秒
举例:
wait until page contains element | id=username | 30 | not found |
说明:
id=username,表示等待定位的元素
30,表示最长等待时间为30秒
not found,自定义错误信息,表示如果等待30秒后id=username元素仍没有出现,则返回该信息
五:断言关键字(关键字中包含should的都是)
关键字名称 | 关键字说明 |
page should contain element | 校验页面是否包含指定的元素 |
page should not contain element | 校验页面是否不包含指定的元素 |
page should contain button | 校验页面是否包含指定按钮 |
page should not contain button | 校验页面是否不包含指定按钮 |
page should contain | 校验当前页面是否包含指定文本 |
element should contain | 校验指定元素是否包含某文本 |
element should be visible | 校验指定的元素应当可见 |
element should not be visible | 校验指定的元素应当不可见 |
element should be enabled | 校验指定的元素应当可用 |
element should be disabled | 校验指定的元素应当不可用 |
element text should be | 校验指定元素的文本内容是否是指定内容 |
element text should not be | 校验指定元素的文本内容是否不是指定内容 |
假如关键字中带有limit=none,那么limit默认为none,当为none时,校验的元素可以是1个也可以是多个,只要元素存在即可。当limit设置了具体数量时,例如:limit设置为1,则只能包含1个,不等于1时则校验失败。
六:浏览器滚动条
方式1:
execute javascript | window.scrollto(0,1000) |
说明:向下滚动1000,0代表x轴不滚动,1000代表y轴向下滚动1000
方式2:
execute javascript execute javascript | var q=document.documentelement.scrolltop=1000 var q=document.body.scrolltop=1000 |
方式3:
Scroll Element Into View | //div[@class="service"][3]//div[@class="serviceItem"] |
七:单选框和复选框的选择
click element locator
select checkbox locator
Press Key locator \ue00d,\ue00d表示按下空格键