Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
c2704b4c
D
Docs
项目概览
OpenHarmony
/
Docs
大约 2 年 前同步成功
通知
161
Star
293
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看板
提交
c2704b4c
编写于
11月 11, 2022
作者:
Z
zhouke
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
js-apis-uitest.md modify.Signed-off-by: <zhouke35@huawei.com>.
Signed-off-by:
N
zhouke
<
zhouke35@huawei.com
>
上级
7e5ce65b
变更
1
显示空白变更内容
内联
并排
Showing
1 changed file
with
363 addition
and
376 deletion
+363
-376
zh-cn/application-dev/reference/apis/js-apis-uitest.md
zh-cn/application-dev/reference/apis/js-apis-uitest.md
+363
-376
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-uitest.md
浏览文件 @
c2704b4c
...
@@ -6,11 +6,11 @@ UiTest提供模拟UI操作的能力,供开发者在测试场景使用,主要
...
@@ -6,11 +6,11 @@ UiTest提供模拟UI操作的能力,供开发者在测试场景使用,主要
-
[
On<sup>9+</sup>
](
#on9
)
:提供控件特征描述能力,用于控件筛选匹配查找。
-
[
On<sup>9+</sup>
](
#on9
)
:提供控件特征描述能力,用于控件筛选匹配查找。
-
[
Component<sup>9+</sup>
](
#component9
)
:代表UI界面上的指定控件,提供控件属性获取,控件点击,滑动查找,文本注入等能力。
-
[
Component<sup>9+</sup>
](
#component9
)
:代表UI界面上的指定控件,提供控件属性获取,控件点击,滑动查找,文本注入等能力。
-
[
Driver<sup>9+</sup>
](
#driver9
)
:入口类,提供控件匹配/查找,按键注入,坐标点击/滑动,截图等能
能
力。
-
[
Driver<sup>9+</sup>
](
#driver9
)
:入口类,提供控件匹配/查找,按键注入,坐标点击/滑动,截图等能力。
-
[
UiWindow<sup>9+</sup>
](
#uiwindow9
)
:入口类,提供窗口属性获取,窗口拖动、调整窗口大小等能能力。
-
[
UiWindow<sup>9+</sup>
](
#uiwindow9
)
:入口类,提供窗口属性获取,窗口拖动、调整窗口大小等能能力。
-
[
By
](
#by
)
:提供控件特征描述能力,用于控件筛选匹配查找。从API version9开始不再维护,建议使用
[
[On<sup>9+</sup>
](
#on9
)
](#driver9)。
-
[
By
](
#by
deprecated
)
:提供控件特征描述能力,用于控件筛选匹配查找。从API version9开始不再维护,建议使用
[
[On<sup>9+</sup>
](
#on9
)
](#driver9)。
-
[
UiComponent
](
#uicomponent
)
:代表UI界面上的指定控件,提供控件属性获取,控件点击,滑动查找,文本注入等能力。从API version9开始不再维护,建议使用
[
Component<sup>9+</sup>
](
#component9
)
。
-
[
UiComponent
](
#uicomponent
deprecated
)
:代表UI界面上的指定控件,提供控件属性获取,控件点击,滑动查找,文本注入等能力。从API version9开始不再维护,建议使用
[
Component<sup>9+</sup>
](
#component9
)
。
-
[
UiDriver
](
#uidriver
)
:入口类,提供控件匹配/查找,按键注入,坐标点击/滑动,截图等能能力。从API version9开始不再维护,建议使用
[
Driver<sup>9+</sup>
](
#driver9
)
。
-
[
UiDriver
](
#uidriver
deprecated
)
:入口类,提供控件匹配/查找,按键注入,坐标点击/滑动,截图等能能力。从API version9开始不再维护,建议使用
[
Driver<sup>9+</sup>
](
#driver9
)
。
>**说明:**
>**说明:**
>
>
...
@@ -20,7 +20,7 @@ UiTest提供模拟UI操作的能力,供开发者在测试场景使用,主要
...
@@ -20,7 +20,7 @@ UiTest提供模拟UI操作的能力,供开发者在测试场景使用,主要
## 导入模块
## 导入模块
```
js
```
js
import
{
UiComponent
,
UiDriver
,
Component
,
Driver
,
UiWindow
,
ON
,
BY
,
MatchPattern
,
DisplayRotation
,
ResizeDirection
,
WindowMode
,
PointerMatrix
}
from
'
@ohos.uitest
'
import
{
UiComponent
,
UiDriver
,
Component
,
Driver
,
UiWindow
,
ON
,
BY
,
MatchPattern
,
DisplayRotation
,
ResizeDirection
,
WindowMode
,
PointerMatrix
}
from
'
@ohos.uitest
'
;
```
```
## MatchPattern
## MatchPattern
...
@@ -122,7 +122,7 @@ UiTest框架在API9中,通过On类提供了丰富的控件特征描述API,
...
@@ -122,7 +122,7 @@ UiTest框架在API9中,通过On类提供了丰富的控件特征描述API,
On提供的API能力具有以下几个特点:
<br>
1、支持单属性匹配和多属性组合匹配,例如同时指定目标控件text和id。
<br>
2、控件属性支持多种匹配模式。
<br>
3、支持控件绝对定位,相对定位,可通过
[
ON.isBefore
](
#isbefore
)
和
[
ON.isAfter
](
#isafter
)
等API限定邻近控件特征进行辅助定位。
<br>
On类提供的所有API均为同步接口,建议使用者通过静态构造器ON来链式创建On对象。
On提供的API能力具有以下几个特点:
<br>
1、支持单属性匹配和多属性组合匹配,例如同时指定目标控件text和id。
<br>
2、控件属性支持多种匹配模式。
<br>
3、支持控件绝对定位,相对定位,可通过
[
ON.isBefore
](
#isbefore
)
和
[
ON.isAfter
](
#isafter
)
等API限定邻近控件特征进行辅助定位。
<br>
On类提供的所有API均为同步接口,建议使用者通过静态构造器ON来链式创建On对象。
```
js
```
js
ON
.
text
(
'
123
'
).
type
(
'
button
'
)
ON
.
text
(
'
123
'
).
type
(
'
button
'
)
;
```
```
### text<sup>9+</sup>
### text<sup>9+</sup>
...
@@ -149,7 +149,7 @@ text(txt: string, pattern?: MatchPattern): On
...
@@ -149,7 +149,7 @@ text(txt: string, pattern?: MatchPattern): On
**示例:**
**示例:**
```
js
```
js
let
on
=
ON
.
text
(
'
123
'
)
//
使用静态构造器ON创建On对象,指定目标控件的text属性。
let
on
=
ON
.
text
(
'
123
'
)
;
//
使用静态构造器ON创建On对象,指定目标控件的text属性。
```
```
...
@@ -176,7 +176,7 @@ id(id: string): On
...
@@ -176,7 +176,7 @@ id(id: string): On
**示例:**
**示例:**
```
js
```
js
let
on
=
ON
.
id
(
123
)
//
使用静态构造器ON创建On对象,指定目标控件的id属性。
let
on
=
ON
.
id
(
'
123
'
);
//
使用静态构造器ON创建On对象,指定目标控件的id属性。
```
```
...
@@ -203,7 +203,7 @@ type(tp: string): On
...
@@ -203,7 +203,7 @@ type(tp: string): On
**示例:**
**示例:**
```
js
```
js
let
on
=
ON
.
type
(
'
button
'
)
//
使用静态构造器ON创建On对象,指定目标控件的控件类型属性。
let
on
=
ON
.
type
(
'
button
'
)
;
//
使用静态构造器ON创建On对象,指定目标控件的控件类型属性。
```
```
...
@@ -230,7 +230,7 @@ clickable(b?: boolean): On
...
@@ -230,7 +230,7 @@ clickable(b?: boolean): On
**示例:**
**示例:**
```
js
```
js
let
on
=
ON
.
clickable
(
true
)
//
使用静态构造器ON创建On对象,指定目标控件的可点击状态属性。
let
on
=
ON
.
clickable
(
true
)
;
//
使用静态构造器ON创建On对象,指定目标控件的可点击状态属性。
```
```
### longClickable<sup>9+</sup>
### longClickable<sup>9+</sup>
...
@@ -256,7 +256,7 @@ longClickable(b?: boolean): On
...
@@ -256,7 +256,7 @@ longClickable(b?: boolean): On
**示例:**
**示例:**
```
js
```
js
let
on
=
ON
.
longClickable
(
true
)
//
使用静态构造器ON创建On对象,指定目标控件的可长按点击状态属性。
let
on
=
ON
.
longClickable
(
true
)
;
//
使用静态构造器ON创建On对象,指定目标控件的可长按点击状态属性。
```
```
...
@@ -283,7 +283,7 @@ scrollable(b?: boolean): On
...
@@ -283,7 +283,7 @@ scrollable(b?: boolean): On
**示例:**
**示例:**
```
js
```
js
let
on
=
ON
.
scrollable
(
true
)
//
使用静态构造器ON创建On对象,指定目标控件的可滑动状态属性。
let
on
=
ON
.
scrollable
(
true
)
;
//
使用静态构造器ON创建On对象,指定目标控件的可滑动状态属性。
```
```
### enabled<sup>9+</sup>
### enabled<sup>9+</sup>
...
@@ -309,7 +309,7 @@ enabled(b?: boolean): On
...
@@ -309,7 +309,7 @@ enabled(b?: boolean): On
**示例:**
**示例:**
```
js
```
js
let
on
=
ON
.
enabled
(
true
)
//
使用静态构造器ON创建On对象,指定目标控件的使能状态属性。
let
on
=
ON
.
enabled
(
true
)
;
//
使用静态构造器ON创建On对象,指定目标控件的使能状态属性。
```
```
### focused<sup>9+</sup>
### focused<sup>9+</sup>
...
@@ -335,7 +335,7 @@ focused(b?: boolean): On
...
@@ -335,7 +335,7 @@ focused(b?: boolean): On
**示例:**
**示例:**
```
js
```
js
let
on
=
ON
.
focused
(
true
)
//
使用静态构造器ON创建On对象,指定目标控件的获焦状态属性。
let
on
=
ON
.
focused
(
true
)
;
//
使用静态构造器ON创建On对象,指定目标控件的获焦状态属性。
```
```
### selected<sup>9+</sup>
### selected<sup>9+</sup>
...
@@ -361,7 +361,7 @@ selected(b?: boolean): On
...
@@ -361,7 +361,7 @@ selected(b?: boolean): On
**示例:**
**示例:**
```
js
```
js
let
on
=
ON
.
selected
(
true
)
//
使用静态构造器ON创建On对象,指定目标控件的被选中状态属性。
let
on
=
ON
.
selected
(
true
)
;
//
使用静态构造器ON创建On对象,指定目标控件的被选中状态属性。
```
```
### checked<sup>9+</sup>
### checked<sup>9+</sup>
...
@@ -387,7 +387,7 @@ checked(b?: boolean): On
...
@@ -387,7 +387,7 @@ checked(b?: boolean): On
**示例:**
**示例:**
```
js
```
js
let
on
=
ON
.
checked
(
true
)
//
使用静态构造器ON创建On对象,指定目标控件的被勾选状态属性
let
on
=
ON
.
checked
(
true
)
;
//
使用静态构造器ON创建On对象,指定目标控件的被勾选状态属性
```
```
### checkable<sup>9+</sup>
### checkable<sup>9+</sup>
...
@@ -413,7 +413,7 @@ checkable(b?: boolean): On
...
@@ -413,7 +413,7 @@ checkable(b?: boolean): On
**示例:**
**示例:**
```
js
```
js
let
on
=
ON
.
checkable
(
true
)
//
使用静态构造器ON创建On对象,指定目标控件的能否被勾选状态属性。
let
on
=
ON
.
checkable
(
true
)
;
//
使用静态构造器ON创建On对象,指定目标控件的能否被勾选状态属性。
```
```
### isBefore<sup>9+</sup>
### isBefore<sup>9+</sup>
...
@@ -439,7 +439,7 @@ isBefore(on: On): On
...
@@ -439,7 +439,7 @@ isBefore(on: On): On
**示例:**
**示例:**
```
js
```
js
let
on
=
ON
.
isBefore
(
ON
.
text
(
'
123
'
))
//
使用静态构造器ON创建On对象,指定目标控件位于给出的特征属性控件之前。
let
on
=
ON
.
isBefore
(
ON
.
text
(
'
123
'
))
;
//
使用静态构造器ON创建On对象,指定目标控件位于给出的特征属性控件之前。
```
```
### isAfter<sup>9+</sup>
### isAfter<sup>9+</sup>
...
@@ -465,7 +465,7 @@ isAfter(on: On): On
...
@@ -465,7 +465,7 @@ isAfter(on: On): On
**示例:**
**示例:**
```
js
```
js
let
on
=
ON
.
isAfter
(
ON
.
text
(
'
123
'
))
//
使用静态构造器ON创建On对象,指定目标控件位于给出的特征属性控件之后。
let
on
=
ON
.
isAfter
(
ON
.
text
(
'
123
'
))
;
//
使用静态构造器ON创建On对象,指定目标控件位于给出的特征属性控件之后。
```
```
## Component<sup>9+</sup>
## Component<sup>9+</sup>
...
@@ -494,9 +494,9 @@ click(): Promise\<void>
...
@@ -494,9 +494,9 @@ click(): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
;
await
button
.
click
()
await
button
.
click
()
;
}
}
```
```
...
@@ -521,9 +521,9 @@ doubleClick(): Promise\<void>
...
@@ -521,9 +521,9 @@ doubleClick(): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
;
await
button
.
doubleClick
()
await
button
.
doubleClick
()
;
}
}
```
```
...
@@ -548,9 +548,9 @@ longClick(): Promise\<void>
...
@@ -548,9 +548,9 @@ longClick(): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
;
await
button
.
longClick
()
await
button
.
longClick
()
;
}
}
```
```
...
@@ -581,9 +581,9 @@ getId(): Promise\<string>
...
@@ -581,9 +581,9 @@ getId(): Promise\<string>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
;
let
num
=
await
button
.
getId
()
let
num
=
await
button
.
getId
()
;
}
}
```
```
...
@@ -614,9 +614,9 @@ getText(): Promise\<string>
...
@@ -614,9 +614,9 @@ getText(): Promise\<string>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
;
let
text
=
await
button
.
getText
()
let
text
=
await
button
.
getText
()
;
}
}
```
```
...
@@ -647,9 +647,9 @@ getType(): Promise\<string>
...
@@ -647,9 +647,9 @@ getType(): Promise\<string>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
;
let
type
=
await
button
.
getType
()
let
type
=
await
button
.
getType
()
;
}
}
```
```
...
@@ -680,9 +680,9 @@ getBounds(): Promise\<Rect>
...
@@ -680,9 +680,9 @@ getBounds(): Promise\<Rect>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
;
let
rect
=
await
button
.
getBounds
()
let
rect
=
await
button
.
getBounds
()
;
}
}
```
```
...
@@ -713,9 +713,9 @@ getBoundsCenter(): Promise\<Point>
...
@@ -713,9 +713,9 @@ getBoundsCenter(): Promise\<Point>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
;
let
point
=
await
button
.
getBoundsCenter
()
let
point
=
await
button
.
getBoundsCenter
()
;
}
}
```
```
...
@@ -746,13 +746,12 @@ isClickable(): Promise\<boolean>
...
@@ -746,13 +746,12 @@ isClickable(): Promise\<boolean>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
;
if
(
await
button
.
isClickable
())
{
if
(
await
button
.
isClickable
())
{
console
.
info
(
'
This button can be Clicked
'
)
console
.
info
(
'
This button can be Clicked
'
);
}
}
else
{
else
{
console
.
info
(
'
This button can not be Clicked
'
);
console
.
info
(
'
This button can not be Clicked
'
)
}
}
}
}
```
```
...
@@ -784,13 +783,12 @@ isLongClickable(): Promise\<boolean>
...
@@ -784,13 +783,12 @@ isLongClickable(): Promise\<boolean>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
;
if
(
await
button
.
isLongClickable
())
{
if
(
await
button
.
isLongClickable
())
{
console
.
info
(
'
This button can longClick
'
)
console
.
info
(
'
This button can longClick
'
);
}
}
else
{
else
{
console
.
info
(
'
This button can not longClick
'
);
console
.
info
(
'
This button can not longClick
'
)
}
}
}
}
```
```
...
@@ -822,13 +820,12 @@ isChecked(): Promise\<boolean>
...
@@ -822,13 +820,12 @@ isChecked(): Promise\<boolean>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
Checkbox
'
))
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
Checkbox
'
))
;
if
(
await
checkBox
.
isChecked
)
{
if
(
await
checkBox
.
isChecked
)
{
console
.
info
(
'
This checkBox is checked
'
)
console
.
info
(
'
This checkBox is checked
'
);
}
}
else
{
else
{
console
.
info
(
'
This checkBox is not checked
'
);
console
.
info
(
'
This checkBox is not checked
'
)
}
}
}
}
```
```
...
@@ -860,13 +857,12 @@ isCheckable(): Promise\<boolean>
...
@@ -860,13 +857,12 @@ isCheckable(): Promise\<boolean>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
Checkbox
'
))
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
Checkbox
'
))
;
if
(
await
checkBox
.
isCheckable
)
{
if
(
await
checkBox
.
isCheckable
)
{
console
.
info
(
'
This checkBox is checkable
'
)
console
.
info
(
'
This checkBox is checkable
'
);
}
}
else
{
else
{
console
.
info
(
'
This checkBox is not checkable
'
);
console
.
info
(
'
This checkBox is not checkable
'
)
}
}
}
}
```
```
...
@@ -898,13 +894,12 @@ isScrollable(): Promise\<boolean>
...
@@ -898,13 +894,12 @@ isScrollable(): Promise\<boolean>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
ON
.
scrollable
(
true
))
let
button
=
await
driver
.
findComponent
(
ON
.
scrollable
(
true
))
;
if
(
await
scrollBar
.
isScrollable
())
{
if
(
await
scrollBar
.
isScrollable
())
{
console
.
info
(
'
This scrollBar can be operated
'
)
console
.
info
(
'
This scrollBar can be operated
'
);
}
}
else
{
else
{
console
.
info
(
'
This scrollBar can not be operated
'
);
console
.
info
(
'
This scrollBar can not be operated
'
)
}
}
}
}
```
```
...
@@ -937,13 +932,12 @@ isEnabled(): Promise\<boolean>
...
@@ -937,13 +932,12 @@ isEnabled(): Promise\<boolean>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
;
if
(
await
button
.
isEnabled
())
{
if
(
await
button
.
isEnabled
())
{
console
.
info
(
'
This button can be operated
'
)
console
.
info
(
'
This button can be operated
'
);
}
}
else
{
else
{
console
.
info
(
'
This button can not be operated
'
);
console
.
info
(
'
This button can not be operated
'
)
}
}
}
}
...
@@ -976,13 +970,12 @@ isFocused(): Promise\<boolean>
...
@@ -976,13 +970,12 @@ isFocused(): Promise\<boolean>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
;
if
(
await
button
.
isFocused
())
{
if
(
await
button
.
isFocused
())
{
console
.
info
(
'
This button is focused
'
)
console
.
info
(
'
This button is focused
'
);
}
}
else
{
else
{
console
.
info
(
'
This button is not focused
'
);
console
.
info
(
'
This button is not focused
'
)
}
}
}
}
```
```
...
@@ -1014,13 +1007,12 @@ isSelected(): Promise\<boolean>
...
@@ -1014,13 +1007,12 @@ isSelected(): Promise\<boolean>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
;
if
(
await
button
.
isSelected
())
{
if
(
await
button
.
isSelected
())
{
console
.
info
(
'
This button is selected
'
)
console
.
info
(
'
This button is selected
'
);
}
}
else
{
else
{
console
.
info
(
'
This button is not selected
'
);
console
.
info
(
'
This button is not selected
'
)
}
}
}
}
```
```
...
@@ -1052,9 +1044,9 @@ inputText(text: string): Promise\<void>
...
@@ -1052,9 +1044,9 @@ inputText(text: string): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
ON
.
text
(
'
hello world
'
))
let
button
=
await
driver
.
findComponent
(
ON
.
text
(
'
hello world
'
))
;
await
text
.
inputText
(
'
123
'
)
await
text
.
inputText
(
'
123
'
)
;
}
}
```
```
...
@@ -1077,9 +1069,9 @@ clearText(): Promise\<void>
...
@@ -1077,9 +1069,9 @@ clearText(): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
ON
.
text
(
'
hello world
'
))
let
button
=
await
driver
.
findComponent
(
ON
.
text
(
'
hello world
'
))
;
await
text
.
clearText
()
await
text
.
clearText
()
;
}
}
```
```
...
@@ -1116,9 +1108,9 @@ scrollSearch(on: ON): Promise\<Component>
...
@@ -1116,9 +1108,9 @@ scrollSearch(on: ON): Promise\<Component>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
Scroll
'
))
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
Scroll
'
))
;
let
button
=
await
scrollBar
.
scrollSearch
(
ON
.
text
(
'
next page
'
))
let
button
=
await
scrollBar
.
scrollSearch
(
ON
.
text
(
'
next page
'
))
;
}
}
```
```
...
@@ -1149,9 +1141,9 @@ scrollToTop(speed?: number): Promise\<void>
...
@@ -1149,9 +1141,9 @@ scrollToTop(speed?: number): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
Scroll
'
))
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
Scroll
'
))
;
await
scrollBar
.
scrollToTop
()
await
scrollBar
.
scrollToTop
()
;
}
}
```
```
...
@@ -1182,9 +1174,9 @@ scrollToBottom(speed?: number): Promise\<void>
...
@@ -1182,9 +1174,9 @@ scrollToBottom(speed?: number): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
Scroll
'
))
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
Scroll
'
))
;
await
scrollBar
.
scrollToBottom
()
await
scrollBar
.
scrollToBottom
()
;
}
}
```
```
...
@@ -1215,10 +1207,10 @@ dragTo(target: Component): Promise\<void>
...
@@ -1215,10 +1207,10 @@ dragTo(target: Component): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
button
'
))
;
let
text
=
await
driver
.
findComponent
(
ON
.
text
(
'
hello world
'
))
let
text
=
await
driver
.
findComponent
(
ON
.
text
(
'
hello world
'
))
;
await
button
.
dragTo
(
text
)
await
button
.
dragTo
(
text
)
;
}
}
```
```
...
@@ -1249,9 +1241,9 @@ pinchOut(scale: number): Promise\<void>
...
@@ -1249,9 +1241,9 @@ pinchOut(scale: number): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
image
'
))
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
image
'
))
;
await
image
.
pinchOut
(
1.5
)
await
image
.
pinchOut
(
1.5
)
;
}
}
```
```
...
@@ -1282,9 +1274,9 @@ pinchIn(scale: number): Promise\<void>
...
@@ -1282,9 +1274,9 @@ pinchIn(scale: number): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
image
'
))
let
button
=
await
driver
.
findComponent
(
ON
.
type
(
'
image
'
))
;
await
image
.
pinchIn
(
0.5
)
await
image
.
pinchIn
(
0.5
)
;
}
}
```
```
...
@@ -1319,7 +1311,7 @@ static create(): Driver
...
@@ -1319,7 +1311,7 @@ static create(): Driver
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
}
}
```
```
...
@@ -1349,8 +1341,8 @@ Driver对象在给定的时间内延时。
...
@@ -1349,8 +1341,8 @@ Driver对象在给定的时间内延时。
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
await
driver
.
delayMs
(
1000
)
await
driver
.
delayMs
(
1000
)
;
}
}
```
```
...
@@ -1386,8 +1378,8 @@ findComponent(on: On): Promise\<Component>
...
@@ -1386,8 +1378,8 @@ findComponent(on: On): Promise\<Component>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
ON
.
text
(
'
next page
'
))
let
button
=
await
driver
.
findComponent
(
ON
.
text
(
'
next page
'
))
;
}
}
```
```
...
@@ -1423,8 +1415,8 @@ findComponents(on: On): Promise\<Array\<Component>>
...
@@ -1423,8 +1415,8 @@ findComponents(on: On): Promise\<Array\<Component>>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
buttonList
=
await
driver
.
findComponents
(
ON
.
text
(
'
next page
'
))
let
buttonList
=
await
driver
.
findComponents
(
ON
.
text
(
'
next page
'
))
;
}
}
```
```
...
@@ -1460,8 +1452,8 @@ findWindow(filter: WindowFilter): Promise\<UiWindow>
...
@@ -1460,8 +1452,8 @@ findWindow(filter: WindowFilter): Promise\<UiWindow>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
;
}
}
```
```
...
@@ -1498,8 +1490,8 @@ waitForComponent(on: On, time: number): Promise\<Component>
...
@@ -1498,8 +1490,8 @@ waitForComponent(on: On, time: number): Promise\<Component>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
button
=
await
driver
.
waitForComponent
(
ON
.
text
(
'
next page
'
),
500
)
let
button
=
await
driver
.
waitForComponent
(
ON
.
text
(
'
next page
'
),
500
)
;
}
}
```
```
...
@@ -1530,8 +1522,8 @@ assertComponentExist(on: On): Promise\<void>
...
@@ -1530,8 +1522,8 @@ assertComponentExist(on: On): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
await
driver
.
assertComponentExist
(
ON
.
text
(
'
next page
'
))
await
driver
.
assertComponentExist
(
ON
.
text
(
'
next page
'
))
;
}
}
```
```
...
@@ -1555,8 +1547,8 @@ Driver对象进行点击BACK键的操作。
...
@@ -1555,8 +1547,8 @@ Driver对象进行点击BACK键的操作。
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
await
driver
.
pressBack
()
await
driver
.
pressBack
()
;
}
}
```
```
...
@@ -1586,8 +1578,8 @@ Driver对象采取如下操作:传入key值实现模拟点击对应按键的
...
@@ -1586,8 +1578,8 @@ Driver对象采取如下操作:传入key值实现模拟点击对应按键的
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
await
driver
.
triggerKey
(
123
)
await
driver
.
triggerKey
(
123
)
;
}
}
```
```
...
@@ -1619,8 +1611,8 @@ Driver对象通过给定的key值,找到对应组合键并点击。例如,Ke
...
@@ -1619,8 +1611,8 @@ Driver对象通过给定的key值,找到对应组合键并点击。例如,Ke
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
await
driver
.
triggerCombineKeys
(
2072
,
2047
,
2035
)
await
driver
.
triggerCombineKeys
(
2072
,
2047
,
2035
)
;
}
}
```
```
...
@@ -1652,8 +1644,8 @@ Driver对象采取如下操作:在目标坐标点单击。
...
@@ -1652,8 +1644,8 @@ Driver对象采取如下操作:在目标坐标点单击。
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
await
driver
.
click
(
100
,
100
)
await
driver
.
click
(
100
,
100
)
;
}
}
```
```
...
@@ -1684,8 +1676,8 @@ Driver对象采取如下操作:在目标坐标点双击。
...
@@ -1684,8 +1676,8 @@ Driver对象采取如下操作:在目标坐标点双击。
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
await
driver
.
doubleClick
(
100
,
100
)
await
driver
.
doubleClick
(
100
,
100
)
;
}
}
```
```
...
@@ -1716,8 +1708,8 @@ Driver对象采取如下操作:在目标坐标点长按。
...
@@ -1716,8 +1708,8 @@ Driver对象采取如下操作:在目标坐标点长按。
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
await
driver
.
longClick
(
100
,
100
)
await
driver
.
longClick
(
100
,
100
)
;
}
}
```
```
...
@@ -1751,8 +1743,8 @@ Driver对象采取如下操作:从起始坐标点滑向目的坐标点。
...
@@ -1751,8 +1743,8 @@ Driver对象采取如下操作:从起始坐标点滑向目的坐标点。
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
await
driver
.
swipe
(
100
,
100
,
200
,
200
,
600
)
await
driver
.
swipe
(
100
,
100
,
200
,
200
,
600
)
;
}
}
```
```
...
@@ -1786,8 +1778,8 @@ Driver对象采取如下操作:从起始坐标点拖拽至目的坐标点。
...
@@ -1786,8 +1778,8 @@ Driver对象采取如下操作:从起始坐标点拖拽至目的坐标点。
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
await
driver
.
drag
(
100
,
100
,
200
,
200
,
600
)
await
driver
.
drag
(
100
,
100
,
200
,
200
,
600
)
;
}
}
```
```
...
@@ -1823,8 +1815,8 @@ Driver对象采取如下操作:捕获当前屏幕,并保存为PNG格式的
...
@@ -1823,8 +1815,8 @@ Driver对象采取如下操作:捕获当前屏幕,并保存为PNG格式的
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
await
driver
.
screenCap
(
'
/local/tmp/
'
)
await
driver
.
screenCap
(
'
/local/tmp/
'
)
;
}
}
```
```
...
@@ -1854,8 +1846,8 @@ setDisplayRotation(rotation: DisplayRotation): Promise\<void>
...
@@ -1854,8 +1846,8 @@ setDisplayRotation(rotation: DisplayRotation): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
await
driver
.
setDisplayRotation
(
DisplayRotation
.
ROTATION_180
)
await
driver
.
setDisplayRotation
(
DisplayRotation
.
ROTATION_180
)
;
}
}
```
```
...
@@ -1885,8 +1877,8 @@ getDisplayRotation(): Promise\<DisplayRotation>
...
@@ -1885,8 +1877,8 @@ getDisplayRotation(): Promise\<DisplayRotation>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
rotation
=
await
driver
.
getDisplayRotation
()
let
rotation
=
await
driver
.
getDisplayRotation
()
;
}
}
```
```
...
@@ -1916,8 +1908,8 @@ setDisplayRotationEnabled(enabled: boolean): Promise\<void>
...
@@ -1916,8 +1908,8 @@ setDisplayRotationEnabled(enabled: boolean): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
await
driver
.
setDisplayRotationEnabled
(
false
)
await
driver
.
setDisplayRotationEnabled
(
false
)
;
}
}
```
```
...
@@ -1947,8 +1939,8 @@ getDisplaySize(): Promise\<Point>
...
@@ -1947,8 +1939,8 @@ getDisplaySize(): Promise\<Point>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
size
=
await
driver
.
getDisplaySize
()
let
size
=
await
driver
.
getDisplaySize
()
;
}
}
```
```
...
@@ -1978,8 +1970,8 @@ getDisplayDensity(): Promise\<Point>
...
@@ -1978,8 +1970,8 @@ getDisplayDensity(): Promise\<Point>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
density
=
await
driver
.
getDisplayDensity
()
let
density
=
await
driver
.
getDisplayDensity
()
;
}
}
```
```
...
@@ -2003,8 +1995,8 @@ wakeUpDisplay(): Promise\<void>
...
@@ -2003,8 +1995,8 @@ wakeUpDisplay(): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
await
driver
.
wakeUpDisplay
()
await
driver
.
wakeUpDisplay
()
;
}
}
```
```
...
@@ -2028,8 +2020,8 @@ pressHome(): Promise\<void>
...
@@ -2028,8 +2020,8 @@ pressHome(): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
await
driver
.
pressHome
()
await
driver
.
pressHome
()
;
}
}
```
```
...
@@ -2066,8 +2058,8 @@ waitForIdle(idleTime: number, timeout: number): Promise\<boolean>
...
@@ -2066,8 +2058,8 @@ waitForIdle(idleTime: number, timeout: number): Promise\<boolean>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
idled
=
await
driver
.
waitForIdle
(
4000
,
5000
)
let
idled
=
await
driver
.
waitForIdle
(
4000
,
5000
)
;
}
}
```
```
...
@@ -2100,8 +2092,8 @@ fling(from: Point, to: Point, stepLen: number, speed: number): Promise\<void>
...
@@ -2100,8 +2092,8 @@ fling(from: Point, to: Point, stepLen: number, speed: number): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
await
driver
.
fling
({
X
:
500
,
Y
:
480
},{
X
:
450
,
Y
:
480
},
5
,
600
)
await
driver
.
fling
({
X
:
500
,
Y
:
480
},{
X
:
450
,
Y
:
480
},
5
,
600
)
;
}
}
```
```
...
@@ -2138,14 +2130,14 @@ injectMultiPointerAction(pointers: PointerMatrix, speed?: number): Promise\<bool
...
@@ -2138,14 +2130,14 @@ injectMultiPointerAction(pointers: PointerMatrix, speed?: number): Promise\<bool
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
pointers
=
PointerMatrix
.
create
(
2
,
3
)
let
pointers
=
PointerMatrix
.
create
(
2
,
3
)
;
pointers
.
setPoint
(
0
,
0
,{
X
:
230
,
Y
:
480
})
pointers
.
setPoint
(
0
,
0
,{
X
:
230
,
Y
:
480
})
;
pointers
.
setPoint
(
0
,
1
,{
X
:
250
,
Y
:
380
})
pointers
.
setPoint
(
0
,
1
,{
X
:
250
,
Y
:
380
})
;
pointers
.
setPoint
(
0
,
2
,{
X
:
270
,
Y
:
280
})
pointers
.
setPoint
(
0
,
2
,{
X
:
270
,
Y
:
280
})
;
pointers
.
setPoint
(
1
,
0
,{
X
:
230
,
Y
:
680
})
pointers
.
setPoint
(
1
,
0
,{
X
:
230
,
Y
:
680
})
;
pointers
.
setPoint
(
1
,
1
,{
X
:
240
,
Y
:
580
})
pointers
.
setPoint
(
1
,
1
,{
X
:
240
,
Y
:
580
})
;
pointers
.
setPoint
(
1
,
2
,{
X
:
250
,
Y
:
480
})
pointers
.
setPoint
(
1
,
2
,{
X
:
250
,
Y
:
480
})
;
await
driver
.
injectMultiPointerAction
(
pointers
)
await
driver
.
injectMultiPointerAction
(
pointers
)
;
}
}
```
```
...
@@ -2178,7 +2170,7 @@ static create(fingers: number, steps: number): PointerMatrix
...
@@ -2178,7 +2170,7 @@ static create(fingers: number, steps: number): PointerMatrix
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
pointerMatrix
=
PointerMatrix
.
create
(
2
,
3
)
let
pointerMatrix
=
PointerMatrix
.
create
(
2
,
3
)
;
}
}
```
```
...
@@ -2202,13 +2194,13 @@ setPoint(finger: number, step: number, point: Point): void
...
@@ -2202,13 +2194,13 @@ setPoint(finger: number, step: number, point: Point): void
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
pointers
=
PointerMatrix
.
create
(
2
,
3
)
let
pointers
=
PointerMatrix
.
create
(
2
,
3
)
;
pointers
.
setPoint
(
0
,
0
,{
X
:
230
,
Y
:
480
})
pointers
.
setPoint
(
0
,
0
,{
X
:
230
,
Y
:
480
})
;
pointers
.
setPoint
(
0
,
1
,{
X
:
250
,
Y
:
380
})
pointers
.
setPoint
(
0
,
1
,{
X
:
250
,
Y
:
380
})
;
pointers
.
setPoint
(
0
,
2
,{
X
:
270
,
Y
:
280
})
pointers
.
setPoint
(
0
,
2
,{
X
:
270
,
Y
:
280
})
;
pointers
.
setPoint
(
1
,
0
,{
X
:
230
,
Y
:
680
})
pointers
.
setPoint
(
1
,
0
,{
X
:
230
,
Y
:
680
})
;
pointers
.
setPoint
(
1
,
1
,{
X
:
240
,
Y
:
580
})
pointers
.
setPoint
(
1
,
1
,{
X
:
240
,
Y
:
580
})
;
pointers
.
setPoint
(
1
,
2
,{
X
:
250
,
Y
:
480
})
pointers
.
setPoint
(
1
,
2
,{
X
:
250
,
Y
:
480
})
;
}
}
```
```
...
@@ -2244,9 +2236,9 @@ getBundleName(): Promise\<string>
...
@@ -2244,9 +2236,9 @@ getBundleName(): Promise\<string>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
;
let
name
=
await
window
.
getBundleName
()
let
name
=
await
window
.
getBundleName
()
;
}
}
```
```
...
@@ -2277,9 +2269,9 @@ getBounds(): Promise\<Rect>
...
@@ -2277,9 +2269,9 @@ getBounds(): Promise\<Rect>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
;
let
rect
=
await
window
.
getBounds
()
let
rect
=
await
window
.
getBounds
()
;
}
}
```
```
...
@@ -2310,9 +2302,9 @@ getTitle(): Promise\<string>
...
@@ -2310,9 +2302,9 @@ getTitle(): Promise\<string>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
;
let
rect
=
await
window
.
getTitle
()
let
rect
=
await
window
.
getTitle
()
;
}
}
```
```
...
@@ -2343,9 +2335,9 @@ getWindowMode(): Promise\<WindowMode>
...
@@ -2343,9 +2335,9 @@ getWindowMode(): Promise\<WindowMode>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
;
let
mode
=
await
window
.
getWindowMode
()
let
mode
=
await
window
.
getWindowMode
()
;
}
}
```
```
...
@@ -2376,9 +2368,9 @@ isFocused(): Promise\<boolean>
...
@@ -2376,9 +2368,9 @@ isFocused(): Promise\<boolean>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
;
let
focused
=
await
window
.
isFocused
()
let
focused
=
await
window
.
isFocused
()
;
}
}
```
```
...
@@ -2409,9 +2401,9 @@ isActived(): Promise\<boolean>
...
@@ -2409,9 +2401,9 @@ isActived(): Promise\<boolean>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
;
let
focused
=
await
window
.
isActived
()
let
focused
=
await
window
.
isActived
()
;
}
}
```
```
...
@@ -2436,9 +2428,9 @@ focus(): Promise\<void>
...
@@ -2436,9 +2428,9 @@ focus(): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
;
await
window
.
focus
()
await
window
.
focus
()
;
}
}
```
```
...
@@ -2471,9 +2463,9 @@ moveTo(x: number, y: number): Promise\<void>
...
@@ -2471,9 +2463,9 @@ moveTo(x: number, y: number): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
;
await
window
.
moveTo
(
100
,
100
)
await
window
.
moveTo
(
100
,
100
)
;
}
}
```
```
...
@@ -2507,9 +2499,9 @@ resize(wide: number, height: number, direction: ResizeDirection): Promise\<void>
...
@@ -2507,9 +2499,9 @@ resize(wide: number, height: number, direction: ResizeDirection): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
;
await
window
.
resize
(
100
,
100
,
ResizeDirection
.
LEFT
)
await
window
.
resize
(
100
,
100
,
ResizeDirection
.
LEFT
)
;
}
}
```
```
...
@@ -2535,9 +2527,9 @@ split(): Promise\<void>
...
@@ -2535,9 +2527,9 @@ split(): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
;
await
window
.
split
()
await
window
.
split
()
;
}
}
```
```
...
@@ -2563,9 +2555,9 @@ maximize(): Promise\<void>
...
@@ -2563,9 +2555,9 @@ maximize(): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
;
await
window
.
maximize
()
await
window
.
maximize
()
;
}
}
```
```
...
@@ -2591,9 +2583,9 @@ minimize(): Promise\<void>
...
@@ -2591,9 +2583,9 @@ minimize(): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
;
await
window
.
minimize
()
await
window
.
minimize
()
;
}
}
```
```
...
@@ -2619,9 +2611,9 @@ resume(): Promise\<void>
...
@@ -2619,9 +2611,9 @@ resume(): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
;
await
window
.
resume
()
await
window
.
resume
()
;
}
}
```
```
...
@@ -2647,21 +2639,21 @@ close(): Promise\<void>
...
@@ -2647,21 +2639,21 @@ close(): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
Driver
.
create
()
let
driver
=
Driver
.
create
()
;
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
let
window
=
await
driver
.
findWindow
({
actived
:
true
})
;
await
window
.
close
()
await
window
.
close
()
;
}
}
```
```
## By<sup>(deprecated)</sup>
## By<sup>(deprecated)</sup>
UiTest框架通过By类提供了丰富的控件特征描述API,用于进行控件筛选来匹配/查找出目标控件。
<br>
UiTest框架通过By类提供了丰富的控件特征描述API,用于进行控件筛选来匹配/查找出目标控件。
<br>
By提供的API能力具有以下几个特点:
<br>
1、支持单属性匹配和多属性组合匹配,例如同时指定目标控件text和id。
<br>
2、控件属性支持多种匹配模式。
<br>
3、支持控件绝对定位,相对定位,可通过
[
By.isBefore
](
#isbefore
)
和
[
By.isAfter
](
#isafter
)
等API限定邻近控件特征进行辅助定位。
<br>
By类提供的所有API均为同步接口,建议使用者通过静态构造器BY来链式创建By对象。
By提供的API能力具有以下几个特点:
<br>
1、支持单属性匹配和多属性组合匹配,例如同时指定目标控件text和id。
<br>
2、控件属性支持多种匹配模式。
<br>
3、支持控件绝对定位,相对定位,可通过
[
By.isBefore
](
#isbefore
deprecated
)
和
[
By.isAfter
](
#isafterdeprecated
)
等API限定邻近控件特征进行辅助定位。
<br>
By类提供的所有API均为同步接口,建议使用者通过静态构造器BY来链式创建By对象。
从API version9开始不再维护,建议使用
[
On<sup>9+</sup>
](
#on9
)
。
从API version9开始不再维护,建议使用
[
On<sup>9+</sup>
](
#on9
)
。
```
js
```
js
BY
.
text
(
'
123
'
).
type
(
'
button
'
)
BY
.
text
(
'
123
'
).
type
(
'
button
'
)
;
```
```
### text<sup>(deprecated)</sup>
### text<sup>(deprecated)</sup>
...
@@ -2684,13 +2676,13 @@ text(txt: string, pattern?: MatchPattern): By
...
@@ -2684,13 +2676,13 @@ text(txt: string, pattern?: MatchPattern): By
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| --------- | ---------------------------------- |
| ---------
----------
| ---------------------------------- |
|
[
By
](
#by
)
| 返回指定目标控件文本属性的By对象。 |
|
[
By
](
#by
deprecated
)
| 返回指定目标控件文本属性的By对象。 |
**示例:**
**示例:**
```
js
```
js
let
by
=
BY
.
text
(
'
123
'
)
//
使用静态构造器BY创建by对象,指定目标控件的text属性。
let
by
=
BY
.
text
(
'
123
'
)
;
//
使用静态构造器BY创建by对象,指定目标控件的text属性。
```
```
...
@@ -2713,13 +2705,13 @@ key(key: string): By
...
@@ -2713,13 +2705,13 @@ key(key: string): By
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| --------- | ----------------------------------- |
| ---------
----------
| ----------------------------------- |
|
[
By
](
#by
)
| 返回指定目标控件key值属性的By对象。 |
|
[
By
](
#by
deprecated
)
| 返回指定目标控件key值属性的By对象。 |
**示例:**
**示例:**
```
js
```
js
let
by
=
BY
.
key
(
'
123
'
)
//
使用静态构造器BY创建by对象,指定目标控件的key值属性。
let
by
=
BY
.
key
(
'
123
'
)
;
//
使用静态构造器BY创建by对象,指定目标控件的key值属性。
```
```
...
@@ -2742,13 +2734,13 @@ id(id: number): By
...
@@ -2742,13 +2734,13 @@ id(id: number): By
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| --------- | -------------------------------- |
| ---------
----------
| -------------------------------- |
|
[
By
](
#by
)
| 返回指定目标控件id属性的By对象。 |
|
[
By
](
#by
deprecated
)
| 返回指定目标控件id属性的By对象。 |
**示例:**
**示例:**
```
js
```
js
let
by
=
BY
.
id
(
123
)
//
使用静态构造器BY创建by对象,指定目标控件的id属性。
let
by
=
BY
.
id
(
123
)
;
//
使用静态构造器BY创建by对象,指定目标控件的id属性。
```
```
...
@@ -2771,13 +2763,13 @@ type(tp: string): By
...
@@ -2771,13 +2763,13 @@ type(tp: string): By
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| --------- | ---------------------------------------- |
| ---------
----------
| ---------------------------------------- |
|
[
By
](
#by
)
| 返回指定目标控件的控件类型属性的By对象。 |
|
[
By
](
#by
deprecated
)
| 返回指定目标控件的控件类型属性的By对象。 |
**示例:**
**示例:**
```
js
```
js
let
by
=
BY
.
type
(
'
button
'
)
//
使用静态构造器BY创建by对象,指定目标控件的控件类型属性。
let
by
=
BY
.
type
(
'
button
'
)
;
//
使用静态构造器BY创建by对象,指定目标控件的控件类型属性。
```
```
...
@@ -2800,13 +2792,13 @@ clickable(b?: boolean): By
...
@@ -2800,13 +2792,13 @@ clickable(b?: boolean): By
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| --------- | ------------------------------------------ |
| ---------
----------
| ------------------------------------------ |
|
[
By
](
#by
)
| 返回指定目标控件的可点击状态属性的By对象。 |
|
[
By
](
#by
deprecated
)
| 返回指定目标控件的可点击状态属性的By对象。 |
**示例:**
**示例:**
```
js
```
js
let
by
=
BY
.
clickable
(
true
)
//
使用静态构造器BY创建by对象,指定目标控件的可点击状态属性。
let
by
=
BY
.
clickable
(
true
)
;
//
使用静态构造器BY创建by对象,指定目标控件的可点击状态属性。
```
```
...
@@ -2829,13 +2821,13 @@ scrollable(b?: boolean): By
...
@@ -2829,13 +2821,13 @@ scrollable(b?: boolean): By
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| --------- | ------------------------------------------ |
| ---------
----------
| ------------------------------------------ |
|
[
By
](
#by
)
| 返回指定目标控件的可滑动状态属性的By对象。 |
|
[
By
](
#by
deprecated
)
| 返回指定目标控件的可滑动状态属性的By对象。 |
**示例:**
**示例:**
```
js
```
js
let
by
=
BY
.
scrollable
(
true
)
//
使用静态构造器BY创建by对象,指定目标控件的可滑动状态属性。
let
by
=
BY
.
scrollable
(
true
)
;
//
使用静态构造器BY创建by对象,指定目标控件的可滑动状态属性。
```
```
### enabled<sup>(deprecated)</sup>
### enabled<sup>(deprecated)</sup>
...
@@ -2857,13 +2849,13 @@ enabled(b?: boolean): By
...
@@ -2857,13 +2849,13 @@ enabled(b?: boolean): By
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| --------- | ---------------------------------------- |
| ---------
----------
| ---------------------------------------- |
|
[
By
](
#by
)
| 返回指定目标控件的使能状态属性的By对象。 |
|
[
By
](
#by
deprecated
)
| 返回指定目标控件的使能状态属性的By对象。 |
**示例:**
**示例:**
```
js
```
js
let
by
=
BY
.
enabled
(
true
)
//
使用静态构造器BY创建by对象,指定目标控件的使能状态属性。
let
by
=
BY
.
enabled
(
true
)
;
//
使用静态构造器BY创建by对象,指定目标控件的使能状态属性。
```
```
### focused<sup>(deprecated)</sup>
### focused<sup>(deprecated)</sup>
...
@@ -2885,13 +2877,13 @@ focused(b?: boolean): By
...
@@ -2885,13 +2877,13 @@ focused(b?: boolean): By
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| --------- | ---------------------------------------- |
| ---------
----------
| ---------------------------------------- |
|
[
By
](
#by
)
| 返回指定目标控件的获焦状态属性的By对象。 |
|
[
By
](
#by
deprecated
)
| 返回指定目标控件的获焦状态属性的By对象。 |
**示例:**
**示例:**
```
js
```
js
let
by
=
BY
.
focused
(
true
)
//
使用静态构造器BY创建by对象,指定目标控件的获焦状态属性。
let
by
=
BY
.
focused
(
true
)
;
//
使用静态构造器BY创建by对象,指定目标控件的获焦状态属性。
```
```
### selected<sup>(deprecated)</sup>
### selected<sup>(deprecated)</sup>
...
@@ -2913,13 +2905,13 @@ selected(b?: boolean): By
...
@@ -2913,13 +2905,13 @@ selected(b?: boolean): By
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| --------- | ------------------------------------------ |
| ---------
----------
| ------------------------------------------ |
|
[
By
](
#by
)
| 返回指定目标控件的被选中状态属性的By对象。 |
|
[
By
](
#by
deprecated
)
| 返回指定目标控件的被选中状态属性的By对象。 |
**示例:**
**示例:**
```
js
```
js
let
by
=
BY
.
selected
(
true
)
//
使用静态构造器BY创建by对象,指定目标控件的被选中状态属性。
let
by
=
BY
.
selected
(
true
)
;
//
使用静态构造器BY创建by对象,指定目标控件的被选中状态属性。
```
```
### isBefore<sup>(deprecated)</sup>
### isBefore<sup>(deprecated)</sup>
...
@@ -2935,19 +2927,19 @@ isBefore(by: By): By
...
@@ -2935,19 +2927,19 @@ isBefore(by: By): By
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | --------- | ---- | ---------------- |
| ------ | ---------
----------
| ---- | ---------------- |
| by |
[
By
](
#by
)
| 是 | 特征控件的属性。 |
| by |
[
By
](
#by
deprecated
)
| 是 | 特征控件的属性。 |
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| --------- | ---------------------------------------------------- |
| ---------
----------
| ---------------------------------------------------- |
|
[
By
](
#by
)
| 返回指定目标控件位于给出的特征属性控件之前的By对象。 |
|
[
By
](
#by
deprecated
)
| 返回指定目标控件位于给出的特征属性控件之前的By对象。 |
**示例:**
**示例:**
```
js
```
js
let
by
=
BY
.
isBefore
(
BY
.
text
(
'
123
'
))
//
使用静态构造器BY创建by对象,指定目标控件位于给出的特征属性控件之前。
let
by
=
BY
.
isBefore
(
BY
.
text
(
'
123
'
))
;
//
使用静态构造器BY创建by对象,指定目标控件位于给出的特征属性控件之前。
```
```
### isAfter<sup>(deprecated)</sup>
### isAfter<sup>(deprecated)</sup>
...
@@ -2963,19 +2955,19 @@ isAfter(by: By): By
...
@@ -2963,19 +2955,19 @@ isAfter(by: By): By
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | --------- | ---- | ---------------- |
| ------ | ---------
----------
| ---- | ---------------- |
| by |
[
By
](
#by
)
| 是 | 特征控件的属性。 |
| by |
[
By
](
#by
deprecated
)
| 是 | 特征控件的属性。 |
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| --------- | ---------------------------------------------------- |
| ---------
----------
| ---------------------------------------------------- |
|
[
By
](
#by
)
| 返回指定目标控件位于给出的特征属性控件之后的By对象。 |
|
[
By
](
#by
deprecated
)
| 返回指定目标控件位于给出的特征属性控件之后的By对象。 |
**示例:**
**示例:**
```
js
```
js
let
by
=
BY
.
isAfter
(
BY
.
text
(
'
123
'
))
//
使用静态构造器BY创建by对象,指定目标控件位于给出的特征属性控件之后。
let
by
=
BY
.
isAfter
(
BY
.
text
(
'
123
'
))
;
//
使用静态构造器BY创建by对象,指定目标控件位于给出的特征属性控件之后。
```
```
## UiComponent<sup>(deprecated)</sup>
## UiComponent<sup>(deprecated)</sup>
...
@@ -2999,9 +2991,9 @@ click(): Promise\<void>
...
@@ -2999,9 +2991,9 @@ click(): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
BY
.
type
(
'
button
'
))
let
button
=
await
driver
.
findComponent
(
BY
.
type
(
'
button
'
))
;
await
button
.
click
()
await
button
.
click
()
;
}
}
```
```
...
@@ -3019,9 +3011,9 @@ doubleClick(): Promise\<void>
...
@@ -3019,9 +3011,9 @@ doubleClick(): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
BY
.
type
(
'
button
'
))
let
button
=
await
driver
.
findComponent
(
BY
.
type
(
'
button
'
))
;
await
button
.
doubleClick
()
await
button
.
doubleClick
()
;
}
}
```
```
...
@@ -3039,9 +3031,9 @@ longClick(): Promise\<void>
...
@@ -3039,9 +3031,9 @@ longClick(): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
BY
.
type
(
'
button
'
))
let
button
=
await
driver
.
findComponent
(
BY
.
type
(
'
button
'
))
;
await
button
.
longClick
()
await
button
.
longClick
()
;
}
}
```
```
...
@@ -3065,9 +3057,9 @@ getId(): Promise\<number>
...
@@ -3065,9 +3057,9 @@ getId(): Promise\<number>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
BY
.
type
(
'
button
'
))
let
button
=
await
driver
.
findComponent
(
BY
.
type
(
'
button
'
))
;
let
num
=
await
button
.
getId
()
let
num
=
await
button
.
getId
()
;
}
}
```
```
...
@@ -3091,9 +3083,9 @@ getKey(): Promise\<string>
...
@@ -3091,9 +3083,9 @@ getKey(): Promise\<string>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
BY
.
type
(
'
button
'
))
let
button
=
await
driver
.
findComponent
(
BY
.
type
(
'
button
'
))
;
let
str_key
=
await
button
.
getKey
()
let
str_key
=
await
button
.
getKey
()
;
}
}
```
```
...
@@ -3117,9 +3109,9 @@ getText(): Promise\<string>
...
@@ -3117,9 +3109,9 @@ getText(): Promise\<string>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
BY
.
type
(
'
button
'
))
let
button
=
await
driver
.
findComponent
(
BY
.
type
(
'
button
'
))
;
let
text
=
await
button
.
getText
()
let
text
=
await
button
.
getText
()
;
}
}
```
```
...
@@ -3143,9 +3135,9 @@ getType(): Promise\<string>
...
@@ -3143,9 +3135,9 @@ getType(): Promise\<string>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
BY
.
type
(
'
button
'
))
let
button
=
await
driver
.
findComponent
(
BY
.
type
(
'
button
'
))
;
let
type
=
await
button
.
getType
()
let
type
=
await
button
.
getType
()
;
}
}
```
```
...
@@ -3169,13 +3161,12 @@ isClickable(): Promise\<boolean>
...
@@ -3169,13 +3161,12 @@ isClickable(): Promise\<boolean>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
BY
.
type
(
'
button
'
))
let
button
=
await
driver
.
findComponent
(
BY
.
type
(
'
button
'
))
;
if
(
await
button
.
isClickable
())
{
if
(
await
button
.
isClickable
())
{
console
.
info
(
'
This button can be Clicked
'
)
console
.
info
(
'
This button can be Clicked
'
);
}
}
else
{
else
{
console
.
info
(
'
This button can not be Clicked
'
);
console
.
info
(
'
This button can not be Clicked
'
)
}
}
}
}
```
```
...
@@ -3200,13 +3191,12 @@ isScrollable(): Promise\<boolean>
...
@@ -3200,13 +3191,12 @@ isScrollable(): Promise\<boolean>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
let
scrollBar
=
await
driver
.
findComponent
(
BY
.
scrollable
(
true
))
let
scrollBar
=
await
driver
.
findComponent
(
BY
.
scrollable
(
true
))
;
if
(
await
scrollBar
.
isScrollable
())
{
if
(
await
scrollBar
.
isScrollable
())
{
console
.
info
(
'
This scrollBar can be operated
'
)
console
.
info
(
'
This scrollBar can be operated
'
);
}
}
else
{
else
{
console
.
info
(
'
This scrollBar can not be operated
'
);
console
.
info
(
'
This scrollBar can not be operated
'
)
}
}
}
}
```
```
...
@@ -3232,13 +3222,12 @@ isEnabled(): Promise\<boolean>
...
@@ -3232,13 +3222,12 @@ isEnabled(): Promise\<boolean>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
BY
.
type
(
'
button
'
))
let
button
=
await
driver
.
findComponent
(
BY
.
type
(
'
button
'
))
;
if
(
await
button
.
isEnabled
())
{
if
(
await
button
.
isEnabled
())
{
console
.
info
(
'
This button can be operated
'
)
console
.
info
(
'
This button can be operated
'
);
}
}
else
{
else
{
console
.
info
(
'
This button can not be operated
'
);
console
.
info
(
'
This button can not be operated
'
)
}
}
}
}
...
@@ -3264,13 +3253,12 @@ isFocused(): Promise\<boolean>
...
@@ -3264,13 +3253,12 @@ isFocused(): Promise\<boolean>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
BY
.
type
(
'
button
'
))
let
button
=
await
driver
.
findComponent
(
BY
.
type
(
'
button
'
))
;
if
(
await
button
.
isFocused
())
{
if
(
await
button
.
isFocused
())
{
console
.
info
(
'
This button is focused
'
)
console
.
info
(
'
This button is focused
'
);
}
}
else
{
else
{
console
.
info
(
'
This button is not focused
'
);
console
.
info
(
'
This button is not focused
'
)
}
}
}
}
```
```
...
@@ -3295,13 +3283,12 @@ isSelected(): Promise\<boolean>
...
@@ -3295,13 +3283,12 @@ isSelected(): Promise\<boolean>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
BY
.
type
(
'
button
'
))
let
button
=
await
driver
.
findComponent
(
BY
.
type
(
'
button
'
))
;
if
(
await
button
.
isSelected
())
{
if
(
await
button
.
isSelected
())
{
console
.
info
(
'
This button is selected
'
)
console
.
info
(
'
This button is selected
'
);
}
}
else
{
else
{
console
.
info
(
'
This button is not selected
'
);
console
.
info
(
'
This button is not selected
'
)
}
}
}
}
```
```
...
@@ -3326,9 +3313,9 @@ inputText(text: string): Promise\<void>
...
@@ -3326,9 +3313,9 @@ inputText(text: string): Promise\<void>
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
let
text
=
await
driver
.
findComponent
(
BY
.
text
(
'
hello world
'
))
let
text
=
await
driver
.
findComponent
(
BY
.
text
(
'
hello world
'
))
;
await
text
.
inputText
(
'
123
'
)
await
text
.
inputText
(
'
123
'
)
;
}
}
```
```
...
@@ -3345,22 +3332,22 @@ scrollSearch(by: By): Promise\<UiComponent>
...
@@ -3345,22 +3332,22 @@ scrollSearch(by: By): Promise\<UiComponent>
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | --------- | ---- | -------------------- |
| ------ | ---------
----------
| ---- | -------------------- |
| by |
[
By
](
#by
)
| 是 | 目标控件的属性要求。 |
| by |
[
By
](
#by
deprecated
)
| 是 | 目标控件的属性要求。 |
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| ------------------------------------- | ------------------------------------- |
| -------------------------------------
----------
| ------------------------------------- |
| Promise
\<
[
UiComponent
](
#uicomponent
)
> | 以Promise形式返回找到的目标控件对象。 |
| Promise
\<
[
UiComponent
](
#uicomponent
deprecated
)
> | 以Promise形式返回找到的目标控件对象。 |
**示例:**
**示例:**
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
let
scrollBar
=
await
driver
.
findComponent
(
BY
.
type
(
'
Scroll
'
))
let
scrollBar
=
await
driver
.
findComponent
(
BY
.
type
(
'
Scroll
'
))
;
let
button
=
await
scrollBar
.
scrollSearch
(
BY
.
text
(
'
next page
'
))
let
button
=
await
scrollBar
.
scrollSearch
(
BY
.
text
(
'
next page
'
))
;
}
}
```
```
...
@@ -3391,7 +3378,7 @@ static create(): UiDriver
...
@@ -3391,7 +3378,7 @@ static create(): UiDriver
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
}
}
```
```
...
@@ -3415,8 +3402,8 @@ UiDriver对象在给定的时间内延时。
...
@@ -3415,8 +3402,8 @@ UiDriver对象在给定的时间内延时。
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
await
driver
.
delayMs
(
1000
)
await
driver
.
delayMs
(
1000
)
;
}
}
```
```
...
@@ -3433,21 +3420,21 @@ findComponent(by: By): Promise\<UiComponent>
...
@@ -3433,21 +3420,21 @@ findComponent(by: By): Promise\<UiComponent>
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | --------- | ---- | -------------------- |
| ------ | ---------
----------
| ---- | -------------------- |
| by |
[
By
](
#by
)
| 是 | 目标控件的属性要求。 |
| by |
[
By
](
#by
deprecated
)
| 是 | 目标控件的属性要求。 |
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| ------------------------------------- | --------------------------------- |
| -------------------------------------
----------
| --------------------------------- |
| Promise
\<
[
UiComponent
](
#uicomponent
)
> | 以Promise形式返回找到的控件对象。 |
| Promise
\<
[
UiComponent
](
#uicomponent
deprecated
)
> | 以Promise形式返回找到的控件对象。 |
**示例:**
**示例:**
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
let
button
=
await
driver
.
findComponent
(
BY
.
text
(
'
next page
'
))
let
button
=
await
driver
.
findComponent
(
BY
.
text
(
'
next page
'
))
;
}
}
```
```
...
@@ -3464,21 +3451,21 @@ findComponents(by: By): Promise\<Array\<UiComponent>>
...
@@ -3464,21 +3451,21 @@ findComponents(by: By): Promise\<Array\<UiComponent>>
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | --------- | ---- | -------------------- |
| ------ | ---------
----------
| ---- | -------------------- |
| by |
[
By
](
#by
)
| 是 | 目标控件的属性要求。 |
| by |
[
By
](
#by
deprecated
)
| 是 | 目标控件的属性要求。 |
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| --------------------------------------------- | --------------------------------------- |
| ---------------------------------------------
----------
| --------------------------------------- |
| Promise
\<
Array
\<
[
UiComponent
](
#uicomponent
)
>> | 以Promise形式返回找到的控件对象的列表。 |
| Promise
\<
Array
\<
[
UiComponent
](
#uicomponent
deprecated
)
>> | 以Promise形式返回找到的控件对象的列表。 |
**示例:**
**示例:**
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
let
buttonList
=
await
driver
.
findComponents
(
BY
.
text
(
'
next page
'
))
let
buttonList
=
await
driver
.
findComponents
(
BY
.
text
(
'
next page
'
))
;
}
}
```
```
...
@@ -3495,15 +3482,15 @@ assertComponentExist(by: By): Promise\<void>
...
@@ -3495,15 +3482,15 @@ assertComponentExist(by: By): Promise\<void>
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | --------- | ---- | -------------------- |
| ------ | ---------
----------
| ---- | -------------------- |
| by |
[
By
](
#by
)
| 是 | 目标控件的属性要求。 |
| by |
[
By
](
#by
deprecated
)
| 是 | 目标控件的属性要求。 |
**示例:**
**示例:**
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
await
driver
.
assertComponentExist
(
BY
.
text
(
'
next page
'
))
await
driver
.
assertComponentExist
(
BY
.
text
(
'
next page
'
))
;
}
}
```
```
...
@@ -3521,8 +3508,8 @@ UiDriver对象进行点击BACK键的操作。
...
@@ -3521,8 +3508,8 @@ UiDriver对象进行点击BACK键的操作。
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
await
driver
.
pressBack
()
await
driver
.
pressBack
()
;
}
}
```
```
...
@@ -3546,8 +3533,8 @@ UiDriver对象采取如下操作:通过key值找到对应键并点击。
...
@@ -3546,8 +3533,8 @@ UiDriver对象采取如下操作:通过key值找到对应键并点击。
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
await
driver
.
triggerKey
(
123
)
await
driver
.
triggerKey
(
123
)
;
}
}
```
```
...
@@ -3573,8 +3560,8 @@ UiDriver对象采取如下操作:在目标坐标点单击。
...
@@ -3573,8 +3560,8 @@ UiDriver对象采取如下操作:在目标坐标点单击。
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
await
driver
.
click
(
100
,
100
)
await
driver
.
click
(
100
,
100
)
;
}
}
```
```
...
@@ -3599,8 +3586,8 @@ UiDriver对象采取如下操作:在目标坐标点双击。
...
@@ -3599,8 +3586,8 @@ UiDriver对象采取如下操作:在目标坐标点双击。
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
await
driver
.
doubleClick
(
100
,
100
)
await
driver
.
doubleClick
(
100
,
100
)
;
}
}
```
```
...
@@ -3625,8 +3612,8 @@ UiDriver对象采取如下操作:在目标坐标点长按下鼠标左键。
...
@@ -3625,8 +3612,8 @@ UiDriver对象采取如下操作:在目标坐标点长按下鼠标左键。
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
await
driver
.
longClick
(
100
,
100
)
await
driver
.
longClick
(
100
,
100
)
;
}
}
```
```
...
@@ -3653,8 +3640,8 @@ UiDriver对象采取如下操作:从给出的起始坐标点滑向给出的目
...
@@ -3653,8 +3640,8 @@ UiDriver对象采取如下操作:从给出的起始坐标点滑向给出的目
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
await
driver
.
swipe
(
100
,
100
,
200
,
200
)
await
driver
.
swipe
(
100
,
100
,
200
,
200
)
;
}
}
```
```
...
@@ -3684,7 +3671,7 @@ UiDriver对象采取如下操作:捕获当前屏幕,并保存为PNG格式的
...
@@ -3684,7 +3671,7 @@ UiDriver对象采取如下操作:捕获当前屏幕,并保存为PNG格式的
```
js
```
js
async
function
demo
()
{
async
function
demo
()
{
let
driver
=
UiDriver
.
create
()
let
driver
=
UiDriver
.
create
()
;
await
driver
.
screenCap
(
'
/local/tmp/
'
)
await
driver
.
screenCap
(
'
/local/tmp/
1.png
'
);
}
}
```
```
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录