- 1 LuckyFrame使用手册
- 2 环境搭建
- 2.1 环境准备
- 2.2 数据库安装配置
- 2.3 基础数据初始化(升级)
- 2.4 Gitee&Github使用说明
- 2.5 导入项目
- 2.6 项目配置
- 2.7 项目部署
- 3 使用说明
- 3.1 系统介绍
- 3.2 语法手册
- 3.2.1 测试驱动(接口)自动化语法说明
- 3.2.2 Web UI自动化语法说明
- 3.2.3 移动端自动化语法说明
- 3.2.4 HTTP&Socket模板自动化语法说明
- 3.2.5 步骤动作关键字
- 4 示例手册
- 4.1 API接口自动化示例
- 4.2 APP自动化示例
- 5 常见问题&解决办法
- 5.1 服务端Web常见问题
- 5.2 客户端常见问题
Web UI自动化语法说明
- 2018-03-15 16:57:42
- admin
- 61458
- 最后编辑:Seagull 于 2020-05-28 17:09:59
1:关键字语法结构
包|定位路径:语法结构 属性 =对应值 示例:xpath =.//*[@id='username'] 元素在页面中的定位路径,定位属性支持请参考下面内容,如果操作不涉及页面元素,此栏为空。
id |
name |
xpath |
linktext |
tagname |
cssselector |
方法|操作:自动联想出Web UI封装好的操作语法
预期结果: 语法结构 check(属性=对应值) 示例:check(xpath=.//*[@id='username']) 此方法用来检查步骤动作执行完成后,检查对应的元素是否存在。
示例:
2:其他关键字语法结构
支持与接口自动化相同关键字语法,写法一样,如:参数传递、模糊匹配预期结果步骤间休眠等,请参考接口自动化的章节,此处不再赘述。
3:web用例调用接口用例
当你的 WEB UI用例需要调用另外一条接口用例或是WEB UI用例的时候,提供一种runcase的方式,在 【方法|操作】列选择runcase,在 【参数】列输入接口用例的编号就可以了。此操作变量不共享。
同时在WEB UI用例也支持插入接口类型的步骤(此操作变量共享)
类似在接口用例中填写步骤的用法,“包 | 定位路径”列填包路径,“方法 | 操作”列填方法名,“参数”列填传给该方法的入参,“预期结果”列可以选填根据方法返回值的断言,“类型”列选接口
示例:
4:元素操作语法
语法结构:动作( 方法|操作) 操作值( 参数)
示例:sendKeys(方法|操作) username(参数)
下拉框类
selectbyvisibletext | 通过下拉框的文本 |
selectbyvalue |
通过下拉框的 VALUE 属 |
selectbyindex |
通过下拉框的 index 属性,从 0 开始计数 |
isselect |
判断是否已经被选择,同用于单选、复选框 |
获取对象属性值类
gettext | 获取文本属性 |
gettagname | 获取标签类型 |
getattribute | 获取指定属性值 |
getcssvalue | 获取cssvalue值 |
getcaptcha | 获取验证码 |
对象动作类
click | 点击 |
sendkeys | 输入 |
clear | 清除输入框 |
gotoframe | 跳转框架(iframe) |
isenabled | 是否可用 |
isdisplayed | 是否可见 |
exjsob | 针对对象执行JS脚本,返回值非空,则使用该返回值返回,可用于用例步骤的预期结果判断;如:通过js获取只读输入框中的内容,然后跟目标值做判断。 |
scrollto |
滚动到目标对象 |
scrollintoview |
将目标对象滚动到可视 |
主对象类(无定位属性)
open | 打开页面 |
exjs | 执行js脚本,返回值非空,则使用该返回值返回,可用于用例步骤的预期结果判断;如:通过js获取只读输入框中的内容,然后跟目标值做判断。 |
gotodefaultcontent |
跳转回到默认 frame(用于跳转到另一个 iframe 后,跳回 |
gettitle | 获取窗口标题 |
getwindowhandle |
参数可以是目标窗口句柄的下标或标题。 下标:从1开始,小于等于0则返回当前窗口的句柄值; 标题:非空则返回第一个匹配的窗口的句柄值,为空则返回当前窗口的句柄值; |
gotowindow |
参数可以是窗口句柄、名称、标题、下标(注:下标从0开始)。先使用句柄和名称查找目标窗口句柄,没有找到再使用标题查找,最后用下标去尝试查找。 |
runcase |
调用指定用例编号的接口|Web UI用例 |
gotoparentframe |
跳转回到上一级iframe |
wait | 等待 |
closewindow |
关闭当前浏览器窗口 |
addcookie |
添加浏览器cookie |
弹出框类
alertaccept | 点击 OK |
alertdismiss | 点击取消 |
alertgettext | 获取弹出框 TEXT |
模拟鼠标键盘类
mouselkclick | 模拟鼠标左键单击(可带页面对象) |
mouserkclick | 模拟鼠标右键单击(可带页面对象) |
mousedclick | 模拟鼠标双击(可带页面对象) |
mouseclickhold | 模拟鼠标左键单击后不释放(可带页面对象) |
mousedrag | 模拟鼠标拖拽(可带页面对象) |
mouseto | 模拟鼠标移动到指定坐标(可带页面对象) |
mouserelease | 模拟鼠标释放(可带页面对象) |
mousekey(tab) | 模拟键盘Tab键 |
mousekey(space) | 模拟键盘Space键 |
mousekey(ctrl) | 模拟键盘Ctrl键 |
mousekey(shift) | 模拟键盘Shift键 |
mousekey(enter) | 模拟键盘Enter键 |
# 检查元素
- check('id=su')
# 单击元素
- click('id=su')