公共语句

为了让自然语言描述的用例能翻译成代码在UI自动化测试平台运行，框架提供了公共语句模板。

为了阅读通顺，语句模板前需要加上无实际含义的介词（假如，当，那么，并且，但是）。

语句模板中"[]"内需输入值，否则语句将视为不合法语句。

以下是常用语句模板：

语句模板	语义	适用于
跳转到[]	跳转到指定的url地址	android 、web
等待[]秒	等待一段时间	ALL
页面渲染完成出现元素[]	进入新的页面时检查指定元素是否渲染完成	ALL
点击[]	点击指定属性的元素	ALL
点击文案[]	点击指定文案的元素	ALL
点击屏幕位置[][]	点击屏幕指定位置	ALL
在 [] 中输入[]	在指定选择器中输入字符串	ALL
在[]中清空并输入[]	在指定选择器中清空并输入字符串	Web
向[] 查找[]的元素	向指定方向查找指定属性的元素	ALL
全屏向[] 滑动[]	全屏向指定方向滑动指定距离	ALL
[] 向[] 滑动[]	在指定区域内向指定方向滑动指定距离	ALL
存在[]的文案	检查页面中存在指定的字符串	ALL
不存在[]的文案	检查页面中不存在指定的字符串	ALL
存在[]的元素	检查页面中存在指定属性的元素	ALL
不存在[]的元素	检查页面中不存在指定属性的元素	ALL
元素[]消失	检查页面中指定属性的元素在指定时间内消失	App
文案[]消失	检查页面中指定的字符串在规定时间内从页面消失	App
文案[] 的属性[] 为 []	检查页面中指定文案的指定属性为指定值	ALL
元素[] 的属性[] 为 []	检查页面中指定元素的指定属性为指定值	ALL
元素[] 位置[] 秒内未变动	检查页面中指定元素的位置在指定时间内未发生变化	App
[] 的文案为[]	检查页面中指定元素的文案等于指定值	ALL
[] 的文案包含[]	检查页面中指定元素的文案包含指定值	ALL
回到首页	回到首页	ALL
全屏截图	保存当前屏幕图像	ALL
开始录屏	开始录制视频	App
开始录屏超时[]	开始录屏并设置超时时间	App
结束录屏	结束录制视频	ALL
连接设备[]	连接测试设备	App
安装APP[]	安装APP	android
删除APP[]	删除APP	android
启动APP[]	启动APP	App
重启APP	重启APP	App
关闭App	关闭App	App
登录账号[] 密码[]	使用账号密码进行登录	ALL
退出登录	退出系统登录	ALL
返回上一页	返回上一页面	Android 、 web
在[]中向[]查找[]的元素	在指定选择器的元素内向指定方向滑动查找指定选择器的元素	ALL
在[]中选择[]	在web页面下拉框元素中选择指定值	web
存在[父选择器]的[子选择器]的元素	存在某个父元素，并且该父元素下存在某个子元素	web
[父选择器]的[子选择器]的文案为[]	存在某个父元素，并且该父元素下某个子元素的文案为指定字符串	web
缓存服务请求[operation[,operation ...]]	缓存该服务的最后一次请求报文到本地。注意： operation 是 url 最后一个\ 和？中间的字符串，即请求名	web
移除请求缓存[operation[,operation ...]]	从本地清除该服务的请求缓存报文。注意： operation 是 url 最后一个\ 和？中间的字符串，即请求名	web
移除所有请求缓存	移除所有请求的缓存报文	web
监听服务[operation[,operation ...]]绑定MockCase[mockCaseId[,mockCaseId ...]]	监听相关operation的请求并拦截，用mockCaseId的返回报文进行替换注意：operation 是url 最后一个\ 和？中间的字符串	web
移除服务监听[operation[,operation ...]]	移除operation 的请求监听注意：operation 是url 最后一个\ 和？中间的字符串	web
移除所有服务监听	移除所有请求监听	web
验证服务请求[operation]与[target_data_path]一致	比对相关operation的缓存报文与target_data_path对应的文件内容注意：operation 是url 最后一个\ 和？中间的字符串	web
验证服务非json请求[operation]与[target_data_path]一致	比对相关operation的非json类型的缓存报文与target_data_path对应的文件内容注意：operation 是url 最后一个\ 和？中间的字符串	web
验证服务[operation]的请求参数[target_json_path]与[expect_value]一致	检查相关operation的缓存报文体对应参数的值与给定的期望值是否一致注意：operation 是url 最后一个\ 和？中间的字符串	web
-----	-----	-----

语句模版：

连接设备[{param}]

支持平台：Android 、 IOS
语义：连接测试设备
例子：连接设备[10.21.37.123:5555]

安装APP[{param}]

支持平台：Android
语义：安装APP
例子：安装APP[/Users/xxx/xxx.apk]

删除APP[{param}]

支持平台：Android
语义：删除APP
例子：删除APP[package name]

启动APP[{param}]

支持平台：Android、iOS
语义：启动APP
例子：启动APP[package name]

重启app

支持平台：Android、iOS
语义：重新启动app

回到首页

语义：跳转到首页
注：用户自定义实现, 在 pscript/app/operation.py 文件中实现 to_home() 方法

登录账号[{param1}]密码[{param2}]

语义：指定用户名、密码登录
注：用户自定义实现, 在 pscript/app/operation.py 文件中实现 login(user_name, password)方法

退出登录

语义:退出当前登录
注：用户自定义实现, 在 pscript/app/operation.py 文件中实现 logout() 方法

存在[字符串{, fuzzyMatch=false, timeout=10}]的文案

支持平台：Android、iOS、Web
语义：页面中存在指定的字符串
timeout 查找的超时时间，优先级：默认值 < flybirds_config.json中的“waitEleTimeout” < 语句中指定

存在[机票]的文案
存在[机票, timeout=10]的文案
存在[.?票, fuzzyMatch=true]的文案

不存在[字符串{, fuzzyMatch=false}]的文案

支持平台：Android、iOS、Web
语义：页面中不存在指定的文案

不存在[机票]的文案
不存在[.?票, fuzzyMatch=true]的文案

文案[字符串{, fuzzyMatch=false, timeout=10}]消失

支持平台：Android、iOS、Web
语义：指定的字符串在规定时间内从页面消失 timeout 等待消失的超时时间，优先级：默认值 < flybirds_config.json中的“waitEleDisappear” < 语句中指定

文案[机票]消失
文案[.?票, fuzzyMatch=true, timeout=20]消失

存在[选择器{, path=false, multiSelector=false, timeout=10}]的元素

支持平台：Android、iOS、Web
语义：页面中存在指定选择器的元素
timeout 查找的超时时间，优先级：默认值 < flybirds_config.json中的“waitEleTimeout” < 语句中指定

存在[center_content_layout]的元素
存在[text=经济舱]的元素
存在[textMatches=.?经济舱]的元素
存在[textMatches=.?经济舱并且type=android.view.ViewGroup, multiSelector=true, timeout=30]的元素
存在[机票→第1个兄弟节点, path=true]的元素

不存在[选择器{, path=false, multiSelector=false}]的元素

支持平台：Android、iOS、Web
语义：页面中不存在指定选择器的元素

不存在[center_content_layout]的元素
不存在[text=经济舱]的元素
不存在textMatches=.?经济舱并且type=android.view.ViewGroup, multiSelector=true]的元素
不存在[机票→第1个兄弟节点, path=true]的元素

元素[选择器{, path=false, multiSelector=false, timeout=10}]消失

支持平台：Android、iOS
语义：指定的选择器在规定时间内从页面消失
timeout 等待消失的超时时间，优先级：默认值 < flybirds_config.json中的“waitEleDisappear” < 语句中指定

元素[center_content_layout]消失
元素[text=机票]消失
元素[机票→第1个兄弟节点, path=true, timeout=15]消失

[选择器{, path=false, multiSelector=false, timeout=10}]的文案为[字符串{, dealMethod=name}]

支持平台：Android、iOS、Web
语义：指定选择器的元素的文案为指定的字符串
timeout 查找的超时时间，优先级：默认值 < flybirds_config.json中的“waitEleTimeout” < 语句中指定

[text=机票]的文案为[机票]
[textMatches=.?经济舱, timeout=15]的文案为[经济舱, dealMethod=trim_prefix]
[textMatches=.?经济舱并且visible=True, multiSelector=true, timeout=15]的文案为[经济舱, dealMethod=trim_prefix]

[选择器{, path=false, multiSelector=false, timeout=10}]的文案包含[字符串{, dealMethod=name}]

支持平台：Android、iOS、Web
语义：指定选择器的元素的文案包含指定的字符串
timeout 查找的超时时间，优先级：默认值 < flybirds_config.json中的“waitEleTimeout” < 语句中指定

[text=机票]的文案包含[票]

[textMatches=.?经济舱, timeout=15]的文案包含[经济舱]

[textMatches=.?经济舱并且visible=True, multiSelector=true, timeout=15]的文案包含[经济, dealMethod=trim_prefix]

页面渲染完成出现元素[选择器{, path=false, multiSelector=false, timeout=10}]

支持平台：Android、iOS、Web
语义：进入新的页面时通过指定选择器的元素出现在页面上来判断页面渲染完成
timeout 查找的超时时间，优先级：默认值 < flybirds_config.json中的“pageRenderTimeout” < 语句中指定

页面渲染完成出现元素[text=机票]

页面渲染完成出现元素[center_content_layout, timeout=15]

页面渲染完成出现元素[center_content_layout, timeout=40]

点击文案[字符串{, fuzzyMatch=false, timeout=10, verifyEle=null, verifyIsPath=false, verifyIsMultiSelector=false, verifyTimeout=10, verifyAction=null}]

支持平台：Android、iOS、Web
语义：点击页面上指定的字符串
timeout 查找“字符串”的超时时间，优先级：默认值 < flybirds_config.json中的“waitEleTimeout” < 语句中指定
verifyEle 点击后如果有局部渲染，使用该属性指定的选择器代表的元素的相关信息判断
verifyIsPath：指定 verifyEle 是否是 path 类型的选择器
verifyIsMultiSelector：指定 verifyEle 是否是多属性类型的选择器
verifyTimeout 判断点击操作的渲染是否完成的超时时间，优先级：默认值 < flybirds_config.json中的“clickVerifyTimeout” < 语句中指定
verifyAction ： verifyEle代表的元素发生特定类型的变化时表示点击后的渲染完成，
position/text/appear/disappear: 位置发生变化/文案发生变化/出现在页面上/从页面消失

点击文案[机票]
点击文案[.?票, fuzzyMatch=true, timeout=15]
点击文案[机票, verifyEle=center_content_layout, verifyAction=position]
点击文案[机票, verifyEle=text=筛选并且type=textView, verifyIsMultiSelector=true, verifyAction=position]

点击[选择器{, path=false, multiSelector=false, timeout=10, verifyEle=null, verifyIsPath=false, verifyIsMultiSelector=false, verifyTimeout=10, verifyAction=null}]

支持平台：Android、iOS、Web
语义: 点击页面上指定选择器的元素
timeout 查找“字符串”的超时时间，优先级：默认值 < flybirds_config.json中的“waitEleTimeout” < 语句中指定
verifyEle 点击后如果有局部渲染，使用该属性指定的选择器代表的元素的相关信息判断
verifyIsPath：指定 verifyEle 是否是 path 类型的选择器
verifyIsMultiSelector：指定 verifyEle 是否是多属性类型的选择器
verifyTimeout 判断点击操作的渲染是否完成的超时时间，优先级：默认值 < flybirds_config.json中的“clickVerifyTimeout” < 语句中指定
verifyAction：verifyEle代表的元素发生特定类型的变化时表示点击后的渲染完成，
position/text/appear/disappear: 位置发生变化/文案发生变化/出现在页面上/从页面消失

点击[text=机票]
点击[textMatches=.?票, timeout=15]
点击[center_content_layout, verifyEle=center_content_layout, verifyAction=position]
点击[testId, verifyEle=text=筛选并且type=textView, verifyIsMultiSelector=true, verifyAction=position]

点击屏幕位置[{x},{y}]

点击屏幕位置[200,100]

文案[字符串{, fuzzyMatch=false, timeout=10}]的属性[属性名{, dealMethod=name}]为{属性值}

支持平台：Android、iOS、Web
语义：页面中指定字符串对应的元素的指定的属性的值为指定的值
timeout 查找“字符串”的超时时间，优先级：默认值 < flybirds_config.json中的“waitEleTimeout” < 语句中指定

文案[机票]的属性[text]为机票
文案[机票, timeout=15]的属性[text, dealMethod=trim_last]为机

元素[选择器{, path=false, multiSelector=false, timeout=10}]的属性[属性名{, dealMethod=name}]为{属性值}

支持平台：Android、iOS、Web
语义：页面中指定选择器的元素的指定的属性的值为指定的值
timeout 查找“字符串”的超时时间，优先级：默认值 < flybirds_config.json中的“waitEleTimeout” < 语句中指定

元素[text=机票]的属性[text]为机票
元素[text=机票, timeout=15]的属性[text, dealMethod=trim_last]为机

在[选择器{, path=false, multiSelector=false, timeout=10}]中输入[文案{, pocoInput=false, afterInputWait=1}]

支持平台：Android、iOS、Web
语义：在指定选择器的元素中输入指定的文案
timeout 查找“字符串”的超时时间，优先级：默认值 < flybirds_config.json中的“waitEleTimeout” < 语句中指定
pocoInput: 是否使用 poco 的输入方法，默认使用的是airtest的输入方法，优先级：默认值 < flybirds_config.json中的“usePocoInput” < 语句中指定
afterInputWait: 输入完成的休眠时间，优先级：默认值 < flybirds_config.json中的“afterInputWait” < 语句中指定

在[inputEleId]中输入[上海]
在[type=InputView]中输入[用户名, pocoInput=true, afterInputWait=5]

[选择器{, path=false, multiSelector=false, timeout=10}]向{上/下/左/右}滑动[滑动距离{, startX=0.5, startY=0.5, duration=null, readyTime=null}]

支持平台：Android、iOS、Web
语义：在指定选择器的滑动容器内向指定方向滑动指定距离
timeout 查找“字符串”的超时时间，优先级：默认值 < flybirds_config.json中的“waitEleTimeout” < 语句中指定
startX: 在容器中滑动起始坐标的X轴的坐标值，<=1 代表百分比，>1代表像素点
startY: 在容器中滑动起始坐标的Y轴的坐标值，<=1 代表百分比，>1代表像素点
duration: 每次滑动的时间，优先级：默认值 < flybirds_config.json中的“swipeDuration” < 语句中指定
readyTime: 滑动开始前的等待时间，优先级：默认值 < flybirds_config.json中的“swipeReadyTime” < 语句中指定

[containerEleId]向左滑动[0.1]
[containerEleId]向上滑动[100, duration=5, readyTime=3]
[containerEleId]向上滑动[100, startX=0.2, startY=0.4, duration=5, readyTime=3]

全屏向{上/下/左/右}滑动[滑动距离{, startX=0.5, startY=0.5, duration=null, readyTime=null}]

支持平台：Android、iOS、Web
语义：以全屏为容器向指定方向滑动指定距离
startX: 在全屏中滑动起始坐标的X轴的坐标值，<=1 代表百分比，>1代表像素点
startY: 在全屏中滑动起始坐标的Y轴的坐标值，<=1 代表百分比，>1代表像素点
duration: 每次滑动的时间，优先级：默认值 < flybirds_config.json中的“swipeDuration” < 语句中指定
readyTime: 滑动开始前的等待时间，优先级：默认值 < flybirds_config.json中的“swipeReadyTime” < 语句中指定

向上滑动[0.05]
向下滑动[0.4, readyTime=3, duration=2]

在[选择器{, path=false, multiSelector=false, timeout=10}]中向{上/下/左/右}查找[选择器{, path=false, multiSelector=false, swipeCount=5, startX=0.5, startY=0.5, distance=0.3, duration=null}]的元素

支持平台：Android、iOS、Web
语义：在指定选择器的元素内向指定方向滑动查找指定选择器的元素
timeout 查找“字符串”的超时时间，优先级：默认值 < flybirds_config.json中的“waitEleTimeout” < 语句中指定
swipeCount: 滑动查找最大滑动次数，超过这个值的滑动操作后还未在页面中找到指定元素则失败，优先级：默认值 < flybirds_config.json中的“swipeSearchCount” < 语句中指定
startX: 在全屏中滑动起始坐标的X轴的坐标值，<=1 代表百分比，>1代表像素点
startY: 在全屏中滑动起始坐标的Y轴的坐标值，<=1 代表百分比，>1代表像素点
duration: 每次滑动的时间，优先级：默认值 < flybirds_config.json中的“searchSwipeDuration” < 语句中指定
distance：滑动查找中每次滑动的距离，优先级：默认值 < flybirds_config.json中的“swipeSearchDistance” < 语句中指定

在[containerId]中向下查找[text=机票]的元素
在[containerId]中向下查找[testId, distance=0.5, duration=2, swipeCount=8]

向{上/下/左/右}查找[选择器{, path=false, multiSelector=false, swipeCount=5, startX=0.5, startY=0.5, distance=0.3, duration=null}]的元素

支持平台：Android、iOS、Web
语义：在全屏向指定方向滑动查找指定选择器的元素
swipeCount: 滑动查找最大滑动次数，超过这个值的滑动操作后还未在页面中找到指定元素则失败，优先级：默认值 < flybirds_config.json中的“swipeSearchCount” < 语句中指定
startX: 在全屏中滑动起始坐标的X轴的坐标值，<=1 代表百分比，>1代表像素点
startY: 在全屏中滑动起始坐标的Y轴的坐标值，<=1 代表百分比，>1代表像素点
duration: 每次滑动的时间，优先级：默认值 < flybirds_config.json中的“searchSwipeDuration” < 语句中指定
distance：滑动查找中每次滑动的距离，优先级：默认值 < flybirds_config.json中的“swipeSearchDistance” < 语句中指定

向下查找[text=机票]的元素
向下查找[testId, distance=0.5, duration=2, swipeCount=8]

元素[选择器{, path=false, multiSelector=false, timeout=10}]位置[time{, verifyCount=5}]秒内未变动

支持平台：Android、iOS
语义：指定选择器的元素在指定时间位置未发生变化，目的是判断页面未处于滑动状态
timeout 查找“字符串”的超时时间，优先级：默认值 < flybirds_config.json中的“waitEleTimeout” < 语句中指定
verifyCount: 最大判断次数，优先级：默认值 < flybirds_config.json中的“verifyPosNotChangeCount” < 语句中指定

开始录屏超时[time]

支持平台：Android、iOS
语义：开始录制屏幕，到超时时间未停止则停止录屏

开始录屏

支持平台：Android、iOS
语义：开始录制屏幕，使用默认的超时时间（在配置文件中配置）

结束录屏

支持平台：Android、iOS、Web
语义：结束录制屏幕，并将视频文件关联到报告中

等待[time]秒

支持平台：Android、iOS、Web
语义：执行暂停指定时间

全屏截图*

支持平台：Android、iOS、Web
语义：截取当前屏幕快照并关联到报告中

跳转到[页面名称]

支持平台：Android、Web
语义：通过schema跳转到指定页面，页面名称在config/schema_url.json 中以 "页面名称: 页面schemaUrl" 的形式维护

跳转到[首页]

缓存服务请求[operation[,operation ...]]

支持平台：Web
语义：缓存该服务的最后一次请求报文到本地。
注意： operation 是 url 最后一个\ 和？中间的字符串，即请求名

//示例1：
缓存服务请求[getRecommendHotelList]

//示例2：
缓存服务请求[getRecommendHotelList,writecookie]

移除请求缓存[operation[,operation ...]]

支持平台：Web
语义：从本地清除该服务请求的缓存报文。
注意： operation 是 url 最后一个\ 和？中间的字符串，即请求名

//示例1：
移除请求缓存[getRecommendHotelList]

//示例2：
移除请求缓存[getRecommendHotelList,writecookie]

移除所有请求缓存

支持平台：Web
语义：移除所有请求的缓存报文

监听服务[operation[,operation ...]]绑定MockCase[mockCaseId[,mockCaseId ...]]

支持平台：Web
语义：监听相关operation的请求并拦截，用mockCaseId的返回报文进行替换。
注意：operation 是url 最后一个\ 和？中间的字符串
MockCase配置：

服务监听step语句的mock数据支持通过2种方式来获取：json文件配置 和 函数调用。
- json文件配置：如以下示例一。具体设置方式及格式可以参考Demo项目mockCaseData 目录下的json文件。
  
  此方式需要注意，对应response 的mockCaseId （json key，如示例一中的4245512）在整个mockCaseData目录下需要是唯一的，否则该mock数据会被其他具有相同 key 的数据覆盖掉。
- 函数调用：自定义处理与获取MockData。此种方式需要在 Demo项目的pscript/custom_handle/operation.py 文件中实现 get_mock_case_body(mock_case_id) 扩展方法。
MockCase 绑定的报文优先以自定义扩展方法的返回结果为主。当自定义扩展方法返回结果为None时，框架会尝试查找项目mockCaseData 目录下的所有json文件，并返回json文件中mock_case_id 对应的 mock数据。

Mock数据配置示例一：json文件配置

{
  "4245512": {
    "count": 101,
    "results": [
      {
        "id": 10,
        "name": "test-狮子王",
        "alias": "The Lion King",
        "cover": "https://p0.meituan.net/movie/27b76fe6cf3903f3d74963f70786001e1438406.jpg@464w_644h_1e_1c",
        "categories": [
          "动画",
          "歌舞",
          "冒险"
        ],
        "published_at": "1995-07-15",
        "minute": 89,
        "score": 9.0,
        "regions": [
          "美国"
        ]
      }
    ]
  }
}

语法使用示例:

//示例1：
监听服务[movie]绑定MockCase[4245512]

//示例2：
监听服务[movie,testList]绑定MockCase[4245512,123456]

移除服务监听[operation[,operation ...]]

支持平台：Web
语义：移除operation 的请求监听
注意：operation 是url 最后一个\ 和？中间的字符串

//示例1：
移除服务监听[movie]

//示例2：
移除服务监听[movie,testList]

移除所有服务监听

支持平台：Web
语义：移除所有请求监听

验证服务请求[operation]与[target_data_path]一致

支持平台：Web
语义：比对相关operation的缓存报文与target_data_path对应的文件内容
注意：operation 是url 最后一个\ 和？中间的字符串

验证服务请求[getRecommendHotelList]与[compareData/getRecommendHotelList.json]一致

验证服务非json请求[operation]与[target_data_path]一致

支持平台：Web
语义：比对相关operation的非json类型的缓存报文与target_data_path对应的文件内容
注意：operation 是url 最后一个\ 和？中间的字符串

验证服务非json请求[writecookie]与[compareData/writecookie.txt]一致

验证服务[operation]的请求参数[target_json_path]与[expect_value]一致

支持平台：Web
语义：检查相关operation的缓存报文体对应参数的值与给定的期望值是否一致
注意：operation 是url 最后一个\ 和？中间的字符串

验证服务[getRecommendHotelList]的请求参数[head.syscode]与[PC]一致

🍖配置忽略节点：

服务报文比对支持设置忽略节点，包括具体路径和正则表达式。具体设置方式及格式可以参考Demo项目interfaceIgnoreConfig 目录下的json文件。

示例：

{
  "getRecommendHotelList": [
    "head.cid",
    "regex: root\\['head'\\]\\['extension'\\]\\[\\d+\\]\\['value'\\]"
  ],
  "writecookie": [
    "token"
  ]
}

说明：

getRecommendHotelList、writecookie 为服务请求的请求名operation
head.cid 为服务getRecommendHotelList 请求体的具体节点路径。与文件进行报文比对时，该节点会被忽略。
regex: root\\['head'\\]\\['extension'\\]\\[\\d+\\]\\['value'\\] 是一个正则表达式。 getRecommendHotelList 请求体中所有匹配该路径的节点在比对时都将被忽略。

🧨 注意： 配置正则表达式时，请在字符串前用regex:进行标注申明。

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

casedsl_zhCN.md

casedsl_zhCN.md

公共语句

以下是常用语句模板：

语句模版：

Files

casedsl_zhCN.md

Latest commit

History

casedsl_zhCN.md

File metadata and controls

公共语句

以下是常用语句模板：

语句模版：