提交 c2704b4c 编写于 作者: Z zhouke

js-apis-uitest.md modify.Signed-off-by: <zhouke35@huawei.com>.

Signed-off-by: Nzhouke <zhouke35@huawei.com>
上级 7e5ce65b
...@@ -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](#bydeprecated):提供控件特征描述能力,用于控件筛选匹配查找。从API version9开始不再维护,建议使用[[On<sup>9+</sup>](#on9)](#driver9)。
- [UiComponent](#uicomponent):代表UI界面上的指定控件,提供控件属性获取,控件点击,滑动查找,文本注入等能力。从API version9开始不再维护,建议使用[Component<sup>9+</sup>](#component9) - [UiComponent](#uicomponentdeprecated):代表UI界面上的指定控件,提供控件属性获取,控件点击,滑动查找,文本注入等能力。从API version9开始不再维护,建议使用[Component<sup>9+</sup>](#component9)
- [UiDriver](#uidriver):入口类,提供控件匹配/查找,按键注入,坐标点击/滑动,截图等能能力。从API version9开始不再维护,建议使用[Driver<sup>9+</sup>](#driver9) - [UiDriver](#uidriverdeprecated):入口类,提供控件匹配/查找,按键注入,坐标点击/滑动,截图等能能力。从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](#isbeforedeprecated)[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](#bydeprecated) | 返回指定目标控件文本属性的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](#bydeprecated) | 返回指定目标控件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](#bydeprecated) | 返回指定目标控件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](#bydeprecated) | 返回指定目标控件的控件类型属性的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](#bydeprecated) | 返回指定目标控件的可点击状态属性的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](#bydeprecated) | 返回指定目标控件的可滑动状态属性的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](#bydeprecated) | 返回指定目标控件的使能状态属性的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](#bydeprecated) | 返回指定目标控件的获焦状态属性的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](#bydeprecated) | 返回指定目标控件的被选中状态属性的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](#bydeprecated) | 是 | 特征控件的属性。 |
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| --------- | ---------------------------------------------------- | | ------------------- | ---------------------------------------------------- |
| [By](#by) | 返回指定目标控件位于给出的特征属性控件之前的By对象。 | | [By](#bydeprecated) | 返回指定目标控件位于给出的特征属性控件之前的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](#bydeprecated) | 是 | 特征控件的属性。 |
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| --------- | ---------------------------------------------------- | | ------------------- | ---------------------------------------------------- |
| [By](#by) | 返回指定目标控件位于给出的特征属性控件之后的By对象。 | | [By](#bydeprecated) | 返回指定目标控件位于给出的特征属性控件之后的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](#bydeprecated) | 是 | 目标控件的属性要求。 |
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------------------------- | ------------------------------------- | | ----------------------------------------------- | ------------------------------------- |
| Promise\<[UiComponent](#uicomponent)> | 以Promise形式返回找到的目标控件对象。 | | Promise\<[UiComponent](#uicomponentdeprecated)> | 以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](#bydeprecated) | 是 | 目标控件的属性要求。 |
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------------------------- | --------------------------------- | | ----------------------------------------------- | --------------------------------- |
| Promise\<[UiComponent](#uicomponent)> | 以Promise形式返回找到的控件对象。 | | Promise\<[UiComponent](#uicomponentdeprecated)> | 以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](#bydeprecated) | 是 | 目标控件的属性要求。 |
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| --------------------------------------------- | --------------------------------------- | | ------------------------------------------------------- | --------------------------------------- |
| Promise\<Array\<[UiComponent](#uicomponent)>> | 以Promise形式返回找到的控件对象的列表。 | | Promise\<Array\<[UiComponent](#uicomponentdeprecated)>> | 以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](#bydeprecated) | 是 | 目标控件的属性要求。 |
**示例:** **示例:**
```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.
先完成此消息的编辑!
想要评论请 注册