Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
c6ddc1ba
D
Docs
项目概览
OpenHarmony
/
Docs
大约 1 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
c6ddc1ba
编写于
5月 24, 2022
作者:
Z
zhouke
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
根据评审意见修改. Signed-off-by: <zhouke25@huawei.com>.
Signed-off-by:
N
zhouke
<
zhouke25@huawe.com
>
上级
f519d8aa
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
34 addition
and
30 deletion
+34
-30
zh-cn/application-dev/reference/apis/js-apis-uitest.md
zh-cn/application-dev/reference/apis/js-apis-uitest.md
+34
-30
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-uitest.md
浏览文件 @
c6ddc1ba
...
...
@@ -14,25 +14,12 @@ import {UiDriver,BY,MatchPattern} from '@ohos.uitest'
## By
UiTest框架通过By类提供了丰富的控件特征描述API,用以进行控件筛选来匹配/查找出目标控件。
<br>
By提供的API能力具有以下几个特点:
<br>
1、支持单属性匹配和多属性组合匹配,例如同时指定目标控件text和id。
<br>
2、控件属性支持多种匹配模式。
<br>
3、支持控件绝对定位,相对定位,可通过
[
isBefore
](
#isBefore
)
和
[
isAfter
](
#
isAfter
)
等API限定邻近控件特征进行辅助定位。
<br>
By类提供的所有API均为同步接口,建议使用者通过静态构造器BY来链式创建By对象。
By提供的API能力具有以下几个特点:
<br>
1、支持单属性匹配和多属性组合匹配,例如同时指定目标控件text和id。
<br>
2、控件属性支持多种匹配模式。
<br>
3、支持控件绝对定位,相对定位,可通过
[
By.isBefore
](
#By.isBefore
)
和
[
By.isAfter
](
#By.
isAfter
)
等API限定邻近控件特征进行辅助定位。
<br>
By类提供的所有API均为同步接口,建议使用者通过静态构造器BY来链式创建By对象。
```
js
BY
.
text
(
'
123
'
).
type
(
'
button
'
)
```
### enum MatchPattern
控件属性支持的匹配模式。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Test.UiTest
| 名称 | 值 | 说明 |
| ------------------------------- | ---- | -------------- |
|
<span
id=
"EQUALS"
></span>
EQUALS | 0 | 等于给定值。 |
| CONTAINS | 1 | 包含给定值。 |
| STARTS_WITH | 2 | 以给定值开始。 |
| ENDS_WITH | 3 | 以给定值结束。 |
### By.text
text(txt: string, pattern?: MatchPattern): By
...
...
@@ -43,10 +30,10 @@ text(txt: string, pattern?: MatchPattern): By
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------------ | ---- | ------------------------------------------- |
| txt | string | 是 | 指定控件文本,用于匹配目标控件文本。 |
| pattern | MatchPattern | 否 | 指定的文本匹配模式,默认为
[
EQUALS
](
#
EQUALS
)
|
| 参数名 | 类型 | 必填 | 说明
|
| ------- | ------------ | ---- | -------------------------------------------
------
|
| txt | string | 是 | 指定控件文本,用于匹配目标控件文本。
|
| pattern | MatchPattern | 否 | 指定的文本匹配模式,默认为
[
EQUALS
](
#
matchpattern
)
|
**返回值:**
...
...
@@ -351,7 +338,7 @@ checkable(b?: bool): By
let
by
=
BY
.
checkable
(
true
)
//使用静态构造器BY创建by对象,指定目标控件的能否被勾选状态属性。
```
###
<span id="isBefore"></span>By.isBefore
###
[By.isBefore](#isBefore)
isBefore(by: By): By
...
...
@@ -377,7 +364,7 @@ isBefore(by: By): By
let
by
=
BY
.
isBefore
(
BY
.
text
(
'
123
'
))
//使用静态构造器BY创建by对象,指定目标控件位于给出的特征属性控件之前。
```
###
<span id="isAfter"></span>By.isAfter
###
[By.isAfter](#isafter)
isAfter(by: By): By
...
...
@@ -1173,9 +1160,10 @@ UiDriver对象采取如下操作:在目标坐标点单击。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------------- | ---- | --------------------------------------------- |
| x,y | number,number | 是 | 以(number,number)的形式传入特定点的坐标信息。 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | -------------------------------------- |
| x | number | 是 | 以number的形式传入目标点的横坐标信息。 |
| y | number | 是 | 以number的形式传入目标点的纵坐标信息。 |
**示例:**
...
...
@@ -1196,9 +1184,10 @@ UiDriver对象采取如下操作:在目标坐标点双击。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------------- | ---- | --------------------------------------------- |
| x,y | number,number | 是 | 以(number,number)的形式传入特定点的坐标信息。 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | -------------------------------------- |
| x | number | 是 | 以number的形式传入目标点的横坐标信息。 |
| y | number | 是 | 以number的形式传入目标点的纵坐标信息。 |
**示例:**
...
...
@@ -1219,10 +1208,10 @@ UiDriver对象采取如下操作:在目标坐标点长按下鼠标左键。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------------------ |
| x | number | 是 |
目标坐标点的横坐标
|
| y | number | 是 |
目标坐标点的纵坐标
|
| 参数名 | 类型 | 必填 | 说明
|
| ------ | ------ | ---- | ------------------
--------------------
|
| x | number | 是 |
以number的形式传入目标点的横坐标信息。
|
| y | number | 是 |
以number的形式传入目标点的纵坐标信息。
|
**示例:**
...
...
@@ -1313,3 +1302,18 @@ async function demo() {
await
driver
.
screenCap
(
'
/local/tmp/
'
)
}
```
## [MatchPattern](#matchpattern)
控件属性支持的匹配模式。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Test.UiTest
| 名称 | 值 | 说明 |
| ----------- | ---- | -------------- |
| EQUALS | 0 | 等于给定值。 |
| CONTAINS | 1 | 包含给定值。 |
| STARTS_WITH | 2 | 从给定值开始。 |
| ENDS_WITH | 3 | 以给定值结束。 |
###
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录