Skip to content

D
Docs

OpenHarmony / Docs
1 年多 前同步成功

通知 159
Star 292
Fork 28
D
Docs
提交 152ace8e 编写于 作者: E ester.zhou
浏览文件
操作

Update docs (16138) 

Signed-off-by: Nester.zhou <ester.zhou@huawei.com>
上级 87db10a3
隐藏空白更改
内联 并排
Showing with 295 addition and 48 deletion
en/application-dev/reference/apis/js-apis-inner-application-accessibilityExtensionContext.md
浏览文件 @ 152ace8e
# AccessibilityExtensionContext (Accessibility Extension Context) # AccessibilityExtensionContext (Accessibility Extension Context)
The **AccessibilityExtensionContext** module, inherited from **ExtensionContext**, provides context for **Accessibility Extension** abilities. The **AccessibilityExtensionContext** module, inherited from **ExtensionContext**, provides context for **AccessibilityExtensionAbility**.
You can use the APIs of this module to configure the concerned information, obtain root information, and inject gestures. You can use the APIs of this module to configure the concerned information, obtain root information, and inject gestures.
...@@ -131,7 +131,7 @@ Sets the concerned target bundle. This API uses an asynchronous callback to retu ...@@ -131,7 +131,7 @@ Sets the concerned target bundle. This API uses an asynchronous callback to retu
let targetNames = ['com.ohos.xyz']; let targetNames = ['com.ohos.xyz'];
try { try {
axContext.setTargetBundleName(targetNames, (err, data) => { axContext.setTargetBundleName(targetNames, (err, data) => {
if (err) { if (err && err.code) {
console.error('failed to set target bundle names, because ${JSON.stringify(err)}'); console.error('failed to set target bundle names, because ${JSON.stringify(err)}');
return; return;
} }
...@@ -214,7 +214,7 @@ For details about the error codes, see [Accessibility Error Codes](../errorcodes ...@@ -214,7 +214,7 @@ For details about the error codes, see [Accessibility Error Codes](../errorcodes
let focusElement; let focusElement;
try { try {
axContext.getFocusElement((err, data) => { axContext.getFocusElement((err, data) => {
if (err) { if (err && err.code) {
console.error('failed to get focus element, because ${JSON.stringify(err)}'); console.error('failed to get focus element, because ${JSON.stringify(err)}');
return; return;
} }
...@@ -248,7 +248,7 @@ let focusElement; ...@@ -248,7 +248,7 @@ let focusElement;
let isAccessibilityFocus = true; let isAccessibilityFocus = true;
try { try {
axContext.getFocusElement(isAccessibilityFocus, (err, data) => { axContext.getFocusElement(isAccessibilityFocus, (err, data) => {
if (err) { if (err && err.code) {
console.error('failed to get focus element, because ${JSON.stringify(err)}'); console.error('failed to get focus element, because ${JSON.stringify(err)}');
return; return;
} }
...@@ -331,7 +331,7 @@ For details about the error codes, see [Accessibility Error Codes](../errorcodes ...@@ -331,7 +331,7 @@ For details about the error codes, see [Accessibility Error Codes](../errorcodes
let rootElement; let rootElement;
try { try {
axContext.getWindowRootElement((err, data) => { axContext.getWindowRootElement((err, data) => {
if (err) { if (err && err.code) {
console.error('failed to get root element of the window, because ${JSON.stringify(err)}'); console.error('failed to get root element of the window, because ${JSON.stringify(err)}');
return; return;
} }
...@@ -373,7 +373,7 @@ let rootElement; ...@@ -373,7 +373,7 @@ let rootElement;
let windowId = 10; let windowId = 10;
try { try {
axContext.getWindowRootElement(windowId, (err, data) => { axContext.getWindowRootElement(windowId, (err, data) => {
if (err) { if (err && err.code) {
console.error('failed to get root element of the window, because ${JSON.stringify(err)}'); console.error('failed to get root element of the window, because ${JSON.stringify(err)}');
return; return;
} }
...@@ -457,7 +457,7 @@ For details about the error codes, see [Accessibility Error Codes](../errorcodes ...@@ -457,7 +457,7 @@ For details about the error codes, see [Accessibility Error Codes](../errorcodes
let windows; let windows;
try { try {
axContext.getWindows((err, data) => { axContext.getWindows((err, data) => {
if (err) { if (err && err.code) {
console.error('failed to get windows, because ${JSON.stringify(err)}'); console.error('failed to get windows, because ${JSON.stringify(err)}');
return; return;
} }
...@@ -499,7 +499,7 @@ let windows; ...@@ -499,7 +499,7 @@ let windows;
let displayId = 10; let displayId = 10;
try { try {
axContext.getWindows(displayId, (err, data) => { axContext.getWindows(displayId, (err, data) => {
if (err) { if (err && err.code) {
console.error('failed to get windows, because ${JSON.stringify(err)}'); console.error('failed to get windows, because ${JSON.stringify(err)}');
return; return;
} }
...@@ -594,7 +594,7 @@ try { ...@@ -594,7 +594,7 @@ try {
gesturePath.points.push(gesturePoint); gesturePath.points.push(gesturePoint);
} }
axContext.injectGesture(gesturePath, (err, data) => { axContext.injectGesture(gesturePath, (err, data) => {
if (err) { if (err && err.code) {
console.error('failed to inject gesture, because ${JSON.stringify(err)}'); console.error('failed to inject gesture, because ${JSON.stringify(err)}');
return; return;
} }
...@@ -818,7 +818,7 @@ Performs an action based on the specified action name. This API uses a promise t ...@@ -818,7 +818,7 @@ Performs an action based on the specified action name. This API uses a promise t
| Name | Type | Mandatory | Description | | Name | Type | Mandatory | Description |
| ----------- | ---------------------------------------- | ---- | -------------- | | ----------- | ---------------------------------------- | ---- | -------------- |
| actionName | string | Yes | Action name. | | actionName | string | Yes | Action name. For details, see [Action](./js-apis-accessibility.md#action).
| parameters | object | No | Parameter required for performing the target action. | | parameters | object | No | Parameter required for performing the target action. |
**Return value** **Return value**
...@@ -861,7 +861,7 @@ Performs an action based on the specified action name. This API uses an asynchro ...@@ -861,7 +861,7 @@ Performs an action based on the specified action name. This API uses an asynchro
| Name | Type | Mandatory | Description | | Name | Type | Mandatory | Description |
| ----------- | ---------------------------------------- | ---- | -------------- | | ----------- | ---------------------------------------- | ---- | -------------- |
| actionName | string | Yes | Attribute name. | | actionName | string | Yes | Action name. For details, see [Action](./js-apis-accessibility.md#action).
| callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result.| | callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result.|
**Error codes** **Error codes**
...@@ -900,7 +900,7 @@ Performs an action based on the specified action name. This API uses an asynchro ...@@ -900,7 +900,7 @@ Performs an action based on the specified action name. This API uses an asynchro
| Name | Type | Mandatory | Description | | Name | Type | Mandatory | Description |
| ----------- | ---------------------------------------- | ---- | -------------- | | ----------- | ---------------------------------------- | ---- | -------------- |
| actionName | string | Yes | Action name. | | actionName | string | Yes | Action name. For details, see [Action](./js-apis-accessibility.md#action).|
| parameters | object | Yes | Parameter required for performing the target action. | | parameters | object | Yes | Parameter required for performing the target action. |
| callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result.| | callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result.|
......
en/application-dev/reference/apis/js-apis-uitest.md
浏览文件 @ 152ace8e
# @ohos.uitest (UiTest) # @ohos.UiTest
The **UiTest** module provides APIs that you can use to simulate UI actions during testing, such as clicks, double-clicks, long-clicks, and swipes. The **UiTest** module provides APIs that you can use to simulate UI actions during testing, such as clicks, double-clicks, long-clicks, and swipes.
...@@ -20,7 +20,7 @@ This module provides the following functions: ...@@ -20,7 +20,7 @@ This module provides the following functions:
## Modules to Import ## Modules to Import
```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, UiDirection, MouseButton} from '@ohos.UiTest';
``` ```
## MatchPattern ## MatchPattern
...@@ -61,8 +61,8 @@ Provides the coordinates of a point. ...@@ -61,8 +61,8 @@ Provides the coordinates of a point.
| Name| Type | Readable| Writable| Description | | Name| Type | Readable| Writable| Description |
| ---- | ------ | ---- | ---- | ---------------- | | ---- | ------ | ---- | ---- | ---------------- |
| X | number | Yes | No | X-coordinate of a point.| | x | number | Yes | No | X-coordinate of a point.|
| Y | number | Yes | No | Y-coordinate of a point.| | y | number | Yes | No | Y-coordinate of a point.|
## Rect<sup>9+</sup> ## Rect<sup>9+</sup>
...@@ -79,10 +79,10 @@ Provides bounds information of a component. ...@@ -79,10 +79,10 @@ Provides bounds information of a component.
## WindowMode<sup>9+</sup> ## WindowMode<sup>9+</sup>
**System capability**: SystemCapability.Test.UiTest
Enumerates the window modes. Enumerates the window modes.
**System capability**: SystemCapability.Test.UiTest
| Name | Value | Description | | Name | Value | Description |
| ---------- | ---- | ---------- | | ---------- | ---- | ---------- |
| FULLSCREEN | 0 | Full-screen mode.| | FULLSCREEN | 0 | Full-screen mode.|
...@@ -92,10 +92,10 @@ Enumerates the window modes. ...@@ -92,10 +92,10 @@ Enumerates the window modes.
## DisplayRotation<sup>9+</sup> ## DisplayRotation<sup>9+</sup>
**System capability**: SystemCapability.Test.UiTest
Describes the display rotation of the device. Describes the display rotation of the device.
**System capability**: SystemCapability.Test.UiTest
| Name | Value | Description | | Name | Value | Description |
| ------------ | ---- | ---------------------------------------- | | ------------ | ---- | ---------------------------------------- |
| ROTATION_0 | 0 | The device display is not rotated and is in its original vertical orientation. | | ROTATION_0 | 0 | The device display is not rotated and is in its original vertical orientation. |
...@@ -116,6 +116,31 @@ Provides the flag attributes of this window. ...@@ -116,6 +116,31 @@ Provides the flag attributes of this window.
| focused | boolean | Yes | No | Whether the window is in focused state. | | focused | boolean | Yes | No | Whether the window is in focused state. |
| actived | boolean | Yes | No | Whether the window is interacting with the user.| | actived | boolean | Yes | No | Whether the window is interacting with the user.|
## UiDirection<sup>10+</sup>
Describes the direction of a UI operation such as fling.
**System capability**: SystemCapability.Test.UiTest
| Name | Value | Description |
| ----- | ---- | ------ |
| LEFT | 0 | Leftward.|
| RIGHT | 1 | Rightward.|
| UP | 2 | Upward.|
| DOWN | 3 | Downward.|
## MouseButton<sup>10+</sup>
Describes the injected simulated mouse button.
**System capability**: SystemCapability.Test.UiTest
| Name | Value | Description |
| ------------------- | ---- | ------------ |
| MOUSE_BUTTON_LEFT | 0 | Left button on the mouse. |
| MOUSE_BUTTON_RIGHT | 1 | Right button on the mouse. |
| MOUSE_BUTTON_MIDDLE | 2 | Middle button on the mouse.|
## On<sup>9+</sup> ## On<sup>9+</sup>
Since API version 9, the UiTest framework provides a wide range of UI component feature description APIs in the **On** class to filter and match components. Since API version 9, the UiTest framework provides a wide range of UI component feature description APIs in the **On** class to filter and match components.
...@@ -420,7 +445,7 @@ let on = ON.checkable(true); // Use the static constructor ON to create an On ob ...@@ -420,7 +445,7 @@ let on = ON.checkable(true); // Use the static constructor ON to create an On ob
isBefore(on: On): On isBefore(on: On): On
Specifies the attributes of the component before which the target component is located. Specifies that the target component is located before the given attribute component.
**System capability**: SystemCapability.Test.UiTest **System capability**: SystemCapability.Test.UiTest
...@@ -428,7 +453,7 @@ Specifies the attributes of the component before which the target component is l ...@@ -428,7 +453,7 @@ Specifies the attributes of the component before which the target component is l
| Name| Type | Mandatory| Description | | Name| Type | Mandatory| Description |
| ------ | ---------- | ---- | -------------------- | | ------ | ---------- | ---- | -------------------- |
| on | [On](#on9) | Yes | Attributes of the component before which the target component is located.| | on | [On](#on9) | Yes | Information about the attribute component.|
**Return value** **Return value**
...@@ -439,14 +464,14 @@ Specifies the attributes of the component before which the target component is l ...@@ -439,14 +464,14 @@ Specifies the attributes of the component before which the target component is l
**Example** **Example**
```js ```js
let on = ON.isBefore(ON.text('123')); // Use the static constructor ON to create an On object and specify the attributes of the component before which the target component is located. let on = ON.isBefore(ON.text('123')); // Create an On object using the static constructor ON, specifying that the target component is located before the given attribute component.
``` ```
### isAfter<sup>9+</sup> ### isAfter<sup>9+</sup>
isAfter(on: On): On isAfter(on: On): On
Specifies the attributes of the component after which the target component is located. Specifies that the target component is located after the given attribute component.
**System capability**: SystemCapability.Test.UiTest **System capability**: SystemCapability.Test.UiTest
...@@ -454,7 +479,7 @@ Specifies the attributes of the component after which the target component is lo ...@@ -454,7 +479,7 @@ Specifies the attributes of the component after which the target component is lo
| Name| Type | Mandatory| Description | | Name| Type | Mandatory| Description |
| ------ | ---------- | ---- | -------------------- | | ------ | ---------- | ---- | -------------------- |
| on | [On](#on9) | Yes | Attributes of the component after which the target component is located.| | on | [On](#on9) | Yes | Information about the attribute component.|
**Return value** **Return value**
...@@ -465,7 +490,59 @@ Specifies the attributes of the component after which the target component is lo ...@@ -465,7 +490,59 @@ Specifies the attributes of the component after which the target component is lo
**Example** **Example**
```js ```js
let on = ON.isAfter(ON.text('123')); // Use the static constructor ON to create an On object and specify the attributes of the component after which the target component is located. let on = ON.isAfter(ON.text('123')); // Create an On object using the static constructor ON, specifying that the target component is located after the given attribute component.
```
### within<sup>10+</sup>
within(on: On): On
Specifies that the target component is located within the given attribute component.
**System capability**: SystemCapability.Test.UiTest
**Parameters**
| Name| Type | Mandatory| Description |
| ------ | ---------- | ---- | -------------------- |
| on | [On](#on9) | Yes | Information about the attribute component.|
**Return value**
| Type | Description |
| ---------- | -------------------------------------------------- |
| [On](#on9) | **On** object.|
**Example**
```js
let on = ON.within(ON.type('List')); // Create an On object using the static constructor ON, specifying that the target component is located within the given attribute component.
```
### inWindow<sup>10+</sup>
inWindow(bundleName: string): On;
Specifies that the target component is within the given application window.
**System capability**: SystemCapability.Test.UiTest
**Parameters**
| Name | Type | Mandatory| Description |
| ---------- | ------ | ---- | ---------------- |
| bundleName | string | Yes | Bundle name of the application window.|
**Return value**
| Type | Description |
| ---------- | ---------------------------------------------- |
| [On](#on9) | **On** object.|
**Example**
```js
let on = ON.inWindow(ON.inWindow('com.uitestScene.acts')); // Create an On object using the static constructor ON, specifying that the target component is within the given application window.
``` ```
## Component<sup>9+</sup> ## Component<sup>9+</sup>
...@@ -1816,7 +1893,7 @@ For details about the error codes, see [UiTest Error Codes](../errorcodes/errorc ...@@ -1816,7 +1893,7 @@ For details about the error codes, see [UiTest Error Codes](../errorcodes/errorc
```js ```js
async function demo() { async function demo() {
let driver = Driver.create(); let driver = Driver.create();
await driver.screenCap('/local/tmp/1.png'); await driver.screenCap('/data/storage/el2/base/cache/1.png');
} }
``` ```
...@@ -2078,7 +2155,7 @@ Simulates a fling operation on the screen. ...@@ -2078,7 +2155,7 @@ Simulates a fling operation on the screen.
| from | [Point](#point9) | Yes | Coordinates of the point where the finger touches the screen. | | from | [Point](#point9) | Yes | Coordinates of the point where the finger touches the screen. |
| to | [Point](#point9) | Yes | Coordinates of the point where the finger leaves the screen. | | to | [Point](#point9) | Yes | Coordinates of the point where the finger leaves the screen. |
| stepLen | number | Yes | Fling step length, in pixels. | | stepLen | number | Yes | Fling step length, in pixels. |
| speed | number | Yes | Scroll speed, in pixel/s. The value ranges from 200 to 15000. If the set value is not in the range, the default value 600 is used.| | speed | number | Yes | Fling speed, in pixel/s. The value ranges from 200 to 40000. If the set value is not in the range, the default value 600 is used.|
**Error codes** **Error codes**
...@@ -2093,7 +2170,7 @@ For details about the error codes, see [UiTest Error Codes](../errorcodes/errorc ...@@ -2093,7 +2170,7 @@ For details about the error codes, see [UiTest Error Codes](../errorcodes/errorc
```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);
} }
``` ```
...@@ -2132,16 +2209,186 @@ For details about the error codes, see [UiTest Error Codes](../errorcodes/errorc ...@@ -2132,16 +2209,186 @@ For details about the error codes, see [UiTest Error Codes](../errorcodes/errorc
async function demo() { async function demo() {
let driver = Driver.create(); let driver = Driver.create();
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);
} }
``` ```
### fling<sup>10+</sup>
fling(direction: UiDirection, speed: number): Promise<void>;
Simulates a fling operation on the screen, in the specified direction and speed.
**System capability**: SystemCapability.Test.UiTest
**Parameters**
| Name | Type | Mandatory| Description |
| --------- | ----------------------------- | ---- | ------------------------------------------------------------ |
| direction | [UiDirection](#uidirection10) | Yes | Direction of the fling operation. |
| speed | number | Yes | Fling speed, in pixel/s. The value ranges from 200 to 40000. If the set value is not in the range, the default value 600 is used.|
**Error codes**
For details about the error codes, see [UiTest Error Codes](../errorcodes/errorcode-uitest.md).
| ID| Error Message |
| -------- | ---------------------------------------- |
| 17000002 | API does not allow calling concurrently. |
**Example**
```js
async function demo() {
let driver = Driver.create();
await driver.fling(UiDirection.DOWN, 10000);
}
```
### screenCapture<sup>10+</sup>
screenCapture(savePath: string, rect?: Rect): Promise<boolean>;
Captures the specified area of the current screen and saves the captured screenshot as a PNG image to the specified path.
**System capability**: SystemCapability.Test.UiTest
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | -------------- | ---- | ---------------------- |
| savePath | string | Yes | File save path. |
| rect | [Rect](#rect9) | No | Area of the screen to capture. The default value is the entire screen.|
**Return value**
| Type | Description |
| ----------------- | -------------------------------------- |
| Promise\<boolean> | Promise used to return the operation result. The value **true** means that the operation is successful.|
**Error codes**
For details about the error codes, see [UiTest Error Codes](../errorcodes/errorcode-uitest.md).
| ID| Error Message |
| -------- | ---------------------------------------- |
| 17000002 | API does not allow calling concurrently. |
**Example**
```js
async function demo() {
let driver = Driver.create();
await driver.screenCapture('/data/storage/el2/base/cache/1.png', {left: 0, top: 0, right: 100, bottom: 100});
}
```
### mouseClick<sup>10+</sup>
mouseClick(p: Point, btnId: MouseButton, key1?: number, key2?: number): Promise<void>;
Injects a mouse click at the specified coordinates, with the optional key or key combination. For example, if the value of **key1** is **2072**, the **Ctrl** button is pressed with the mouse click.
**System capability**: SystemCapability.Test.UiTest
**Parameters**
| Name| Type | Mandatory| Description |
| ------ | ----------------------------- | ---- | ------------------- |
| p | [Point](#point9) | Yes | Coordinates of the mouse click. |
| btnId | [MouseButton](#mousebutton10) | Yes | Mouse button pressesd. |
| key1 | number | Yes | The first key value.|
| key2 | number | No | The second key value.|
**Error codes**
For details about the error codes, see [UiTest Error Codes](../errorcodes/errorcode-uitest.md).
| ID| Error Message |
| -------- | ---------------------------------------- |
| 17000002 | API does not allow calling concurrently. |
**Example**
```js
async function demo() {
let driver = Driver.create();
await driver.mouseClick({x:248, y:194}, MouseButton.MOUSE_BUTTON_LEFT, 2072);
}
```
### mouseScroll<sup>10+</sup>
mouseScroll(p: Point, down: boolean, d: number, key1?: number, key2?: number): Promise<void>;
Injects a mouse scroll action at the specified coordinates, with the optional key or key combination. For example, if the value of **key1** is **2072**, the **Ctrl** button is pressed with mouse scrolling.
**System capability**: SystemCapability.Test.UiTest
**Parameters**
| Name| Type | Mandatory| Description |
| ------ | ---------------- | ---- | --------------------------------------------------- |
| p | [Point](#point9) | Yes | Coordinates of the mouse click. |
| down | boolean | Yes | Whether the scroll wheel slides downward. |
| d | number | Yes | Number of grids by which the scroll wheel slides. Sliding by one grid means a 120-pixel offset of the target point.|
| key1 | number | Yes | The first key value. |
| key2 | number | No | The second key value. |
**Error codes**
For details about the error codes, see [UiTest Error Codes](../errorcodes/errorcode-uitest.md).
| ID| Error Message |
| -------- | ---------------------------------------- |
| 17000002 | API does not allow calling concurrently. |
**Example**
```js
async function demo() {
let driver = Driver.create();
await driver.mouseScroll({x:360, y:640}, true, 30, 2072)
}
```
### mouseMoveTo<sup>10+</sup>
mouseMoveTo(p: Point): Promise<void>;
Moves the cursor to the target point.
**System capability**: SystemCapability.Test.UiTest
**Parameters**
| Name| Type | Mandatory| Description |
| ------ | ---------------- | ---- | -------------- |
| p | [Point](#point9) | Yes | Coordinates of the target point.|
**Error codes**
For details about the error codes, see [UiTest Error Codes](../errorcodes/errorcode-uitest.md).
| ID| Error Message |
| -------- | ---------------------------------------- |
| 17000002 | API does not allow calling concurrently. |
**Example**
```js
async function demo() {
let driver = Driver.create();
await driver.mouseMoveTo({x:100, y:100})
}
```
## PointerMatrix<sup>9+</sup> ## PointerMatrix<sup>9+</sup>
Implements a **PointerMatrix** object that stores coordinates and behaviors of each action of each finger in a multi-touch operation. Implements a **PointerMatrix** object that stores coordinates and behaviors of each action of each finger in a multi-touch operation.
...@@ -2196,12 +2443,12 @@ Sets the coordinates for the action corresponding to the specified finger and st ...@@ -2196,12 +2443,12 @@ Sets the coordinates for the action corresponding to the specified finger and st
```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});
} }
``` ```
...@@ -2919,7 +3166,7 @@ let by = BY.selected(true); // Use the static constructor BY to create a By obje ...@@ -2919,7 +3166,7 @@ let by = BY.selected(true); // Use the static constructor BY to create a By obje
isBefore(by: By): By isBefore(by: By): By
Specifies the attributes of the component before which the target component is located. Specifies that the target component is located before the given attribute component.
This API is deprecated since API version 9. You are advised to use [isBefore<sup>9+</sup>](#isbefore9). This API is deprecated since API version 9. You are advised to use [isBefore<sup>9+</sup>](#isbefore9).
...@@ -2929,7 +3176,7 @@ This API is deprecated since API version 9. You are advised to use [isBefore<sup ...@@ -2929,7 +3176,7 @@ This API is deprecated since API version 9. You are advised to use [isBefore<sup
| Name| Type | Mandatory| Description | | Name| Type | Mandatory| Description |
| ------ | ------------------- | ---- | ---------------- | | ------ | ------------------- | ---- | ---------------- |
| by | [By](#bydeprecated) | Yes | Attributes of the component before which the target component is located.| | by | [By](#bydeprecated) | Yes | Information about the attribute component.|
**Return value** **Return value**
...@@ -2940,14 +3187,14 @@ This API is deprecated since API version 9. You are advised to use [isBefore<sup ...@@ -2940,14 +3187,14 @@ This API is deprecated since API version 9. You are advised to use [isBefore<sup
**Example** **Example**
```js ```js
let by = BY.isBefore(BY.text('123')); // Use the static constructor BY to create a By object and specify the attributes of the component before which the target component is located. let by = BY.isBefore(BY.text('123')); // Use the static constructor BY to create a By object, specifying that the target component is located before the given attribute component.
``` ```
### isAfter<sup>(deprecated)</sup> ### isAfter<sup>(deprecated)</sup>
isAfter(by: By): By isAfter(by: By): By
Specifies the attributes of the component after which the target component is located. Specifies the target component is located after the given attribute component.
This API is deprecated since API version 9. You are advised to use [isAfter<sup>9+</sup>](#isafter9). This API is deprecated since API version 9. You are advised to use [isAfter<sup>9+</sup>](#isafter9).
...@@ -2957,7 +3204,7 @@ This API is deprecated since API version 9. You are advised to use [isAfter<sup> ...@@ -2957,7 +3204,7 @@ This API is deprecated since API version 9. You are advised to use [isAfter<sup>
| Name| Type | Mandatory| Description | | Name| Type | Mandatory| Description |
| ------ | ------------------- | ---- | ---------------- | | ------ | ------------------- | ---- | ---------------- |
| by | [By](#bydeprecated) | Yes | Attributes of the component before which the target component is located.| | by | [By](#bydeprecated) | Yes | Information about the attribute component.|
**Return value** **Return value**
...@@ -2968,7 +3215,7 @@ This API is deprecated since API version 9. You are advised to use [isAfter<sup> ...@@ -2968,7 +3215,7 @@ This API is deprecated since API version 9. You are advised to use [isAfter<sup>
**Example** **Example**
```js ```js
let by = BY.isAfter(BY.text('123')); // Use the static constructor BY to create a By object and specify the attributes of the component after which the target component is located. let by = BY.isAfter(BY.text('123')); // Use the static constructor BY to create a By object, specifying that the target component is located after the given attribute component.
``` ```
## UiComponent<sup>(deprecated)</sup> ## UiComponent<sup>(deprecated)</sup>
...@@ -3673,6 +3920,6 @@ This API is deprecated since API version 9. You are advised to use [screenCap<su ...@@ -3673,6 +3920,6 @@ This API is deprecated since API version 9. You are advised to use [screenCap<su
```js ```js
async function demo() { async function demo() {
let driver = UiDriver.create(); let driver = UiDriver.create();
await driver.screenCap('/local/tmp/1.png'); await driver.screenCap('/data/storage/el2/base/cache/1.png');
} }
``` ```
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或