Added 6 ability-related APIs

Signed-off-by: Nwusongqing <wusongqing@huawei.com>

en/application-dev/reference/apis/js-apis-abilityDelegatorRegistry.md

+# AbilityDelegatorRegistry
+
+> **NOTE**
+>
+> The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version.
+
+## Modules to Import
+
+```js
+import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry'
+```
+
+
+
+## AbilityLifecycleState
+
+Enumerates the ability lifecycle states.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+| Name         | Value  | Description                       |
+| ------------- | ---- | --------------------------- |
+| UNINITIALIZED | 0    | The ability is in an invalid state.             |
+| CREATE        | 1    | The ability is created.|
+| FOREGROUND    | 2    | The ability is running in the foreground.  |
+| BACKGROUND    | 3    | The ability is running in the background.  |
+| DESTROY       | 4    | The ability is destroyed.|
+
+
+
+## AbilityDelegatorRegistry.getAbilityDelegator
+
+getAbilityDelegator(): AbilityDelegator
+
+Obtains the **AbilityDelegator** object of the application.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Return value**
+
+| Type                                                        | Description                                                        |
+| ------------------------------------------------------------ | ------------------------------------------------------------ |
+| [AbilityDelegator](js-apis-application-abilityDelegator.md#AbilityDelegator) | [AbilityDelegator](js-apis-application-abilityDelegator.md#AbilityDelegator) object, which can be used to schedule functions related to the test framework.|
+
+**Example**
+
+```js
+var abilityDelegator;
+
+abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+```
+
+
+
+## AbilityDelegatorRegistry.getArguments
+
+getArguments(): AbilityDelegatorArgs
+
+Obtains the **AbilityDelegatorArgs** object of the application.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Return value**
+
+| Type                                                        | Description                                                        |
+| ------------------------------------------------------------ | ------------------------------------------------------------ |
+| [AbilityDelegatorArgs](js-apis-application-abilityDelegatorArgs.md#AbilityDelegatorArgs) | [AbilityDelegatorArgs](js-apis-application-abilityDelegatorArgs.md#AbilityDelegatorArgs) object, which can be used to obtain test parameters.|
+
+**Example**
+
+```js
+var args = AbilityDelegatorRegistry.getArguments();
+console.info("getArguments bundleName:" + args.bundleName);
+console.info("getArguments testCaseNames:" + args.testCaseNames);
+console.info("getArguments testRunnerClassName:" + args.testRunnerClassName);
+```

en/application-dev/reference/apis/js-apis-application-abilityDelegator.md

+# AbilityDelegator
+
+> **Note**
+>
+> The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version.
+
+## Modules to Import
+
+```js
+import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry'
+```
+
+
+
+## AbilityDelegator
+
+### addAbilityMonitor<sup>9+</sup>
+
+addAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\<void>): void
+
+Adds an **AbilityMonitor** instance. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Parameters**
+
+| Name  | Type                                                        | Mandatory| Description                                                        |
+| -------- | ------------------------------------------------------------ | -------- | ------------------------------------------------------------ |
+| monitor  | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor) | Yes      | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor) instance.|
+| callback | AsyncCallback\<void>                                         | Yes      | Callback used to return the result.                                          |
+
+**Example**
+
+```js
+var abilityDelegator;
+
+function onAbilityCreateCallback() {
+    console.info("onAbilityCreateCallback");
+}
+
+var monitor = {
+    abilityName: "abilityname",
+    onAbilityCreate: onAbilityCreateCallback
+}
+
+abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+abilityDelegator.addAbilityMonitor(monitor, (err) => {
+    console.info("addAbilityMonitor callback");
+});
+```
+
+
+
+### addAbilityMonitor<sup>9+</sup>
+
+addAbilityMonitor(monitor: AbilityMonitor): Promise\<void>
+
+Adds an **AbilityMonitor** instance. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Parameters**
+
+| Name | Type                                                        | Mandatory| Description                                                        |
+| ------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
+| monitor | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor) | Yes  | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor) instance.|
+
+**Return value**
+
+| Type          | Description               |
+| -------------- | ------------------- |
+| Promise\<void> | Promise used to return the result.|
+
+**Example**
+
+```js
+var abilityDelegator;
+
+function onAbilityCreateCallback() {
+    console.info("onAbilityCreateCallback");
+}
+
+var monitor = {
+    abilityName: "abilityname",
+    onAbilityCreate: onAbilityCreateCallback
+}
+
+abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+abilityDelegator.addAbilityMonitor(monitor).then(() => {
+    console.info("addAbilityMonitor promise");
+});
+```
+
+
+
+### removeAbilityMonitor<sup>9+</sup>
+
+removeAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\<void>): void
+
+Removes an **AbilityMonitor** instance. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Parameters**
+
+| Name  | Type                                                        | Mandatory| Description                                                        |
+| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
+| monitor  | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor) | Yes  | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor) instance.|
+| callback | AsyncCallback\<void>                                         | Yes  | Callback used to return the result.                                          |
+
+**Example**
+
+```js
+var abilityDelegator;
+
+function onAbilityCreateCallback() {
+    console.info("onAbilityCreateCallback");
+}
+
+var monitor = {
+    abilityName: "abilityname",
+    onAbilityCreate: onAbilityCreateCallback
+}
+
+abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+abilityDelegator.removeAbilityMonitor(monitor, (err) => {
+    console.info("removeAbilityMonitor callback");
+});
+```
+
+
+
+### removeAbilityMonitor<sup>9+</sup>
+
+removeAbilityMonitor(monitor: AbilityMonitor): Promise\<void>
+
+Removes an **AbilityMonitor** instance. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Parameters**
+
+| Name   | Type                                                        | Mandatory| Description                                                        |
+| ------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
+| monitor | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor) | Yes  | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor) instance.|
+
+**Return value**
+
+| Type          | Description               |
+| -------------- | ------------------- |
+| Promise\<void> | Promise used to return the result.|
+
+- Example
+
+```js
+var abilityDelegator;
+
+function onAbilityCreateCallback() {
+    console.info("onAbilityCreateCallback");
+}
+
+var monitor = {
+    abilityName: "abilityname",
+    onAbilityCreate: onAbilityCreateCallback
+}
+
+abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+abilityDelegator.removeAbilityMonitor(monitor).then(() => {
+    console.info("removeAbilityMonitor promise");
+});
+```
+
+
+
+### waitAbilityMonitor<sup>9+</sup>
+
+waitAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\<Ability>): void
+
+Waits for the ability that matches the **AbilityMonitor** instance to reach the **OnCreate** lifecycle and returns the **Ability** instance. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Parameters**
+
+| Name  | Type                                                        | Mandatory| Description                                                        |
+| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
+| monitor  | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor) | Yes  | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor) instance.|
+| callback | AsyncCallback\<[Ability](js-apis-application-ability.md#Ability)> | Yes  | Callback used to return the ability.                                          |
+
+**Example**
+
+```js
+var abilityDelegator;
+
+function onAbilityCreateCallback() {
+    console.info("onAbilityCreateCallback");
+}
+
+var monitor = {
+    abilityName: "abilityname",
+    onAbilityCreate: onAbilityCreateCallback
+}
+
+abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+abilityDelegator.waitAbilityMonitor(monitor, (err, data) => {
+    console.info("waitAbilityMonitor callback");
+});
+```
+
+
+
+### waitAbilityMonitor<sup>9+</sup>
+
+waitAbilityMonitor(monitor: AbilityMonitor, timeout: number, callback: AsyncCallback\<Ability>): void
+
+Waits a period of time for the ability that matches the **AbilityMonitor** instance to reach the **OnCreate** lifecycle and returns the **Ability** instance. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Parameters**
+
+| Name  | Type                                                        | Mandatory| Description                                                        |
+| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
+| monitor  | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor) | Yes  | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor) instance.|
+| timeout  | number                                                       | Yes  | Maximum waiting time, in milliseconds.                                |
+| callback | AsyncCallback\<[Ability](js-apis-application-ability.md#Ability)> | Yes  | Callback used to return the ability.                                          |
+
+**Example**
+
+```js
+var abilityDelegator;
+var timeout = 100;
+
+function onAbilityCreateCallback() {
+    console.info("onAbilityCreateCallback");
+}
+
+var monitor = {
+    abilityName: "abilityname",
+    onAbilityCreate: onAbilityCreateCallback
+}
+
+abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+abilityDelegator.waitAbilityMonitor(monitor, timeout, (err, data) => {
+    console.info("waitAbilityMonitor callback");
+});
+```
+
+
+
+### waitAbilityMonitor<sup>9+</sup>
+
+waitAbilityMonitor(monitor: AbilityMonitor, timeout?: number): Promise\<Ability>
+
+Waits a period of time for the ability that matches the **AbilityMonitor** instance to reach the **OnCreate** lifecycle and returns the **Ability** instance. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Parameters**
+
+| Name | Type                                                        | Mandatory| Description                                                        |
+| ------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
+| monitor | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor) | Yes  | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor) instance.|
+| timeout | number                                                       | No  | Maximum waiting time, in milliseconds.                                |
+
+**Return value**
+
+| Type                                                       | Description                      |
+| ----------------------------------------------------------- | -------------------------- |
+| Promise\<[Ability](js-apis-application-ability.md#Ability)> | Promise used to return the **Ability** instance.|
+
+**Example**
+
+```js
+var abilityDelegator;
+
+function onAbilityCreateCallback() {
+    console.info("onAbilityCreateCallback");
+}
+
+var monitor = {
+    abilityName: "abilityname",
+    onAbilityCreate: onAbilityCreateCallback
+}
+
+abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+abilityDelegator.waitAbilityMonitor(monitor).then((data : any) => {
+    console.info("waitAbilityMonitor promise");
+});
+```
+
+
+
+### getAppContext<sup>9+</sup>
+
+getAppContext(): Context
+
+Obtains the application context.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Return value**
+
+| Type                                 | Description                                       |
+| ------------------------------------- | ------------------------------------------- |
+| [Context](js-apis-Context.md#Context) | [Context](js-apis-Context.md#Context) of the application.|
+
+**Example**
+
+```js
+var abilityDelegator;
+
+abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+var context = abilityDelegator.getAppContext();
+```
+
+
+
+### getAbilityState<sup>9+</sup>
+
+getAbilityState(ability: Ability): number
+
+Obtains the lifecycle state of an ability.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Parameters**
+
+| Name | Type                                             | Mandatory| Description           |
+| ------- | ------------------------------------------------- | ---- | --------------- |
+| ability | [Ability](js-apis-application-ability.md#Ability) | Yes  | Target ability.|
+
+**Return value**
+
+| Type  | Description                                                        |
+| ------ | ------------------------------------------------------------ |
+| number | Lifecycle state of the ability. For details about the available enumerated values, see [AbilityLifecycleState](js-apis-abilityDelegatorRegistry.md#AbilityLifecycleState).|
+
+**Example**
+
+```js
+var abilityDelegator;
+var ability;
+
+abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+abilityDelegator.getCurrentTopAbility((err, data) => {
+    console.info("getCurrentTopAbility callback");
+    ability = data;
+    var state = abilityDelegator.getAbilityState(ability);
+    console.info("getAbilityState" + state);
+});
+```
+
+
+
+### getCurrentTopAbility<sup>9+</sup>
+
+getCurrentTopAbility(callback: AsyncCallback\<Ability>): void
+
+Obtains the top ability of the application. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Parameters**
+
+| Name  | Type                                                        | Mandatory| Description              |
+| -------- | ------------------------------------------------------------ | ---- | ------------------ |
+| callback | AsyncCallback\<[Ability](js-apis-application-ability.md#Ability)> | Yes  | Callback used to return the top ability.|
+
+**Example**
+
+```js
+var abilityDelegator;
+var ability;
+
+abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+abilityDelegator.getCurrentTopAbility((err, data) => {
+    console.info("getCurrentTopAbility callback");
+    ability = data;
+});
+```
+
+
+
+### getCurrentTopAbility<sup>9+</sup>
+
+getCurrentTopAbility(): Promise\<Ability>
+
+Obtains the top ability of the application. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Return value**
+
+| Type                                                       | Description                                  |
+| ----------------------------------------------------------- | -------------------------------------- |
+| Promise\<[Ability](js-apis-application-ability.md#Ability)> | Promise used to return the top ability.|
+
+**Example**
+
+```js
+var abilityDelegator;
+var ability;
+
+abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+abilityDelegator.getCurrentTopAbility().then((data : any) => {
+    console.info("getCurrentTopAbility promise");
+    ability = data;
+});
+```
+
+
+
+### startAbility
+
+startAbility(want: Want, callback: AsyncCallback\<void>): void
+
+Starts an ability. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Parameters**
+
+| Name  | Type                                  | Mandatory| Description              |
+| -------- | -------------------------------------- | ---- | ------------------ |
+| want     | [Want](js-apis-featureAbility.md#Want) | Yes  | **Want** parameter for starting the ability.   |
+| callback | AsyncCallback\<void>                   | Yes  | Callback used to return the result.|
+
+**Example**
+
+```js
+var abilityDelegator;
+var want = {
+    bundleName: "bundleName",
+    abilityName: "abilityName"
+};
+
+abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+abilityDelegator.startAbility(want, (err, data) => {
+    console.info("startAbility callback");
+});
+```
+
+
+
+### startAbility
+
+startAbility(want: Want): Promise\<void>
+
+Starts an ability. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Parameters**
+
+| Name| Type                                  | Mandatory| Description           |
+| ------ | -------------------------------------- | ---- | --------------- |
+| want   | [Want](js-apis-featureAbility.md#Want) | Yes  | **Want** parameter for starting the ability.|
+
+**Return value**
+
+| Type          | Description               |
+| -------------- | ------------------- |
+| Promise\<void> | Promise used to return the result.|
+
+**Example**
+
+```js
+var abilityDelegator;
+var want = {
+    bundleName: "bundleName",
+    abilityName: "abilityName"
+};
+
+abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+abilityDelegator.startAbility(want).then((data: any) => {
+    console.info("startAbility promise");
+});
+```
+
+
+
+### doAbilityForeground<sup>9+</sup>
+
+doAbilityForeground(ability: Ability, callback: AsyncCallback\<boolean>): void
+
+Schedules the lifecycle state of an ability to **Foreground**. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Parameters**
+
+| Name  | Type                   | Mandatory| Description                                                   |
+| -------- | ----------------------- | ---- | ------------------------------------------------------- |
+| ability  | Ability                 | Yes  | Target ability.                                        |
+| callback | AsyncCallback\<boolean> | Yes  | Callback used to return the result.<br>\- **true**: The operation is successful.<br>\- **false**: The operation fails.|
+
+**Example**
+
+```js
+var abilityDelegator;
+var ability;
+
+abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+abilityDelegator.getCurrentTopAbility((err, data) => {
+    console.info("getCurrentTopAbility callback");
+    ability = data;
+    abilityDelegator.doAbilityForeground(ability, (err, data) => {
+        console.info("doAbilityForeground callback");
+    });
+});
+```
+
+
+
+### doAbilityForeground<sup>9+</sup>
+
+doAbilityForeground(ability: Ability): Promise\<boolean>
+
+Schedules the lifecycle state of an ability to **Foreground**. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Parameters**
+
+| Name | Type   | Mandatory| Description           |
+| ------- | ------- | ---- | --------------- |
+| ability | Ability | Yes  | Target ability.|
+
+**Return value**
+
+| Type             | Description                                                        |
+| ----------------- | ------------------------------------------------------------ |
+| Promise\<boolean> | Promise used to return the result.<br>\- **true**: The operation is successful.<br>\- **false**: The operation fails.|
+
+**Example**
+
+```js
+var abilityDelegator;
+var ability;
+
+abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+abilityDelegator.getCurrentTopAbility((err, data) => {
+    console.info("getCurrentTopAbility callback");
+    ability = data;
+    abilityDelegator.doAbilityForeground(ability).then((data : any) => {
+        console.info("doAbilityForeground promise");
+    });
+});
+```
+
+
+
+### doAbilityBackground<sup>9+</sup>
+
+doAbilityBackground(ability: Ability, callback: AsyncCallback\<boolean>): void
+
+Schedules the lifecycle state of an ability to **Background**. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Parameters**
+
+| Name  | Type                   | Mandatory| Description                                                   |
+| -------- | ----------------------- | ---- | ------------------------------------------------------- |
+| ability  | Ability                 | Yes  | Target ability.                                        |
+| callback | AsyncCallback\<boolean> | Yes  | Callback used to return the result.<br>\- **true**: The operation is successful.<br>\- **false**: The operation fails.|
+
+**Example**
+
+```js
+var abilityDelegator;
+var ability;
+
+abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+abilityDelegator.getCurrentTopAbility((err, data) => {
+    console.info("getCurrentTopAbility callback");
+    ability = data;
+    abilityDelegator.doAbilityBackground(ability, (err, data) => {
+        console.info("doAbilityBackground callback");
+    });
+});
+```
+
+
+
+### doAbilityBackground<sup>9+</sup>
+
+doAbilityBackground(ability: Ability): Promise\<boolean>
+
+Schedules the lifecycle state of an ability to **Background**. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Parameters**
+
+| Name | Type   | Mandatory| Description           |
+| ------- | ------- | ---- | --------------- |
+| ability | Ability | Yes  | Target ability.|
+
+**Return value**
+
+| Type             | Description                                                        |
+| ----------------- | ------------------------------------------------------------ |
+| Promise\<boolean> | Promise used to return the result.<br>\- **true**: The operation is successful.<br>\- **false**: The operation fails.|
+
+**Example**
+
+```js
+var abilityDelegator;
+var ability;
+
+abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+abilityDelegator.getCurrentTopAbility((err, data) => {
+    console.info("getCurrentTopAbility callback");
+    ability = data;
+    abilityDelegator.doAbilityBackground(ability).then((data) => {
+        console.info("doAbilityBackground promise");
+    });
+});
+```
+
+
+
+### print
+
+print(msg: string, callback: AsyncCallback\<void>): void
+
+Prints log information to the unit test console. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Parameters**
+
+| Name  | Type                | Mandatory| Description              |
+| -------- | -------------------- | ---- | ------------------ |
+| msg      | string               | Yes  | Log string.        |
+| callback | AsyncCallback\<void> | Yes  | Callback used to return the result.|
+
+**Example**
+
+```js
+var abilityDelegator;
+var msg = "msg";
+
+abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+abilityDelegator.print(msg, (err) => {
+    console.info("print callback");
+});
+```
+
+
+
+### print
+
+print(msg: string): Promise\<void>
+
+Prints log information to the unit test console. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Parameters**
+
+| Name| Type  | Mandatory| Description      |
+| ------ | ------ | ---- | ---------- |
+| msg    | string | Yes  | Log string.|
+
+**Return value**
+
+| Type          | Description               |
+| -------------- | ------------------- |
+| Promise\<void> | Promise used to return the result.|
+
+**Example**
+
+```js
+var abilityDelegator;
+var msg = "msg";
+
+abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+abilityDelegator.print(msg).then(() => {
+    console.info("print promise");
+});
+```
+
+
+
+### executeShellCommand
+
+executeShellCommand(cmd: string, callback: AsyncCallback\<ShellCmdResult>): void
+
+Executes a shell command. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Parameters**
+
+| Name  | Type                                                        | Mandatory| Description              |
+| -------- | ------------------------------------------------------------ | ---- | ------------------ |
+| cmd      | string                                                       | Yes  | Shell command string.   |
+| callback | AsyncCallback\<[ShellCmdResult](js-apis-application-shellCmdResult.md#ShellCmdResult)> | Yes  | Callback used to return a [ShellCmdResult](js-apis-application-shellCmdResult.md#ShellCmdResult) object.|
+
+**Example**
+
+```js
+var abilityDelegator;
+var cmd = "cmd";
+
+abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+abilityDelegator.executeShellCommand(cmd, (err, data) => {
+    console.info("executeShellCommand callback");
+});
+```
+
+
+
+### executeShellCommand
+
+executeShellCommand(cmd: string, timeoutSecs: number, callback: AsyncCallback\<ShellCmdResult>): void
+
+Executes a shell command with the timeout period specified. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Parameters**
+
+| Name     | Type                                                        | Mandatory| Description                         |
+| ----------- | ------------------------------------------------------------ | ---- | ----------------------------- |
+| cmd         | string                                                       | Yes  | Shell command string.              |
+| timeoutSecs | number                                                       | Yes  | Command timeout period, in seconds.|
+| callback    | AsyncCallback\<[ShellCmdResult](js-apis-application-shellCmdResult.md#ShellCmdResult)> | Yes  | Callback used to return a [ShellCmdResult](js-apis-application-shellCmdResult.md#ShellCmdResult) object.           |
+
+**Example**
+
+```js
+var abilityDelegator;
+var cmd = "cmd";
+var timeout = 100;
+
+abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+abilityDelegator.executeShellCommand(cmd, timeout, (err, data) => {
+    console.info("executeShellCommand callback");
+});
+```
+
+
+
+### executeShellCommand
+
+executeShellCommand(cmd: string, timeoutSecs: number): Promise\<ShellCmdResult>
+
+Executes a shell command with the timeout period specified. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Parameters**
+
+| Name     | Type  | Mandatory| Description                         |
+| ----------- | ------ | ---- | ----------------------------- |
+| cmd         | string | Yes  | Shell command string.              |
+| timeoutSecs | number | No  | Command timeout period, in seconds.|
+
+**Return value**
+
+| Type                                                        | Description                                                        |
+| ------------------------------------------------------------ | ------------------------------------------------------------ |
+| Promise\<[ShellCmdResult](js-apis-application-shellCmdResult.md#ShellCmdResult)> | Promise used to return a [ShellCmdResult](js-apis-application-shellCmdResult.md#ShellCmdResult) object.|
+
+**Example**
+
+```js
+var abilityDelegator;
+var cmd = "cmd";
+var timeout = 100;
+
+abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+abilityDelegator.executeShellCommand(cmd, timeout).then((data : any) => {
+    console.info("executeShellCommand promise");
+});
+```

en/application-dev/reference/apis/js-apis-application-abilityDelegatorArgs.md

+# AbilityDelegatorArgs
+
+> **NOTE**
+>
+> The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version.
+
+## Modules to Import
+
+```js
+import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry'
+```
+
+
+
+## AbilityDelegatorArgs
+
+Describes the test parameters.
+
+| Name               | Type                  | Readable| Writable| Description                                                        |
+| ------------------- | ---------------------- | ---- | ---- | ------------------------------------------------------------ |
+| bundleName          | string                 | Yes  | Yes  | Bundle name of the application to test.<br>**System capability**: SystemCapability.Ability.AbilityRuntime.Core|
+| parameters          | {[key:string]: string} | Yes  | Yes  | Parameters of the unit test that is started currently.<br>**System capability**: SystemCapability.Ability.AbilityRuntime.Core|
+| testCaseNames       | string                 | Yes  | Yes  | Test case names.<br>**System capability**: SystemCapability.Ability.AbilityRuntime.Core|
+| testRunnerClassName | string                 | Yes  | Yes  | Names of the test executors that execute the test cases.<br>**System capability**: SystemCapability.Ability.AbilityRuntime.Core|

en/application-dev/reference/apis/js-apis-application-abilityMonitor.md

+# AbilityMonitor
+
+> **NOTE**
+>
+> The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.
+
+## Modules to Import
+
+```js
+import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry'
+```
+
+
+
+## AbilityMonitor
+
+Describes an ability monitor.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+| Name                | Type    | Readable| Writable| Description                                                        |
+| -------------------- | -------- | ---- | ---- | ------------------------------------------------------------ |
+| abilityName          | string   | Yes  | Yes  | Name of the ability bound to the ability monitor.                       |
+| onAbilityCreate      | function | Yes  | Yes  | Called when the ability is created.<br>If this attribute is not set, the corresponding lifecycle callback cannot be received.|
+| onAbilityForeground  | function | Yes  | Yes  | Called when the ability starts to run in the foreground.<br>If this attribute is not set, the corresponding lifecycle callback cannot be received.|
+| onAbilityBackground  | function | Yes  | Yes  | Called when the ability starts to run in the background.<br>If this attribute is not set, the corresponding lifecycle callback cannot be received.|
+| onAbilityDestroy     | function | Yes  | Yes  | Called when the ability is destroyed.<br>If this attribute is not set, the corresponding lifecycle callback cannot be received.|
+| onWindowStageCreate  | function | Yes  | Yes  | Called when the window stage is created.<br>If this attribute is not set, the corresponding lifecycle callback cannot be received.|
+| onWindowStageRestore | function | Yes  | Yes  | Called when the window stage is restored.<br>If this attribute is not set, the corresponding lifecycle callback cannot be received.|
+| onWindowStageDestroy | function | Yes  | Yes  | Called when the window stage is destroyed.<br>If this attribute is not set, the corresponding lifecycle callback cannot be received.|

en/application-dev/reference/apis/js-apis-application-shellCmdResult.md

+# ShellCmdResult
+
+> **NOTE**
+>
+> The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version.
+
+## Modules to Import
+
+```js
+import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry'
+```
+
+
+
+## ShellCmdResult
+
+Describes the shell command execution result.
+
+| Name     | Type  | Readable| Writable| Description                                                        |
+| --------- | ------ | ---- | ---- | ------------------------------------------------------------ |
+| stdResult | string | Yes  | Yes  | Standard output content.<br>**System capability**: SystemCapability.Ability.AbilityRuntime.Core|
+| exitCode  | number | Yes  | Yes  | Result code.<br>**System capability**: SystemCapability.Ability.AbilityRuntime.Core|

en/application-dev/reference/apis/js-apis-testRunner.md

+# TestRunner
+
+> **Note**
+>
+> The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version.
+
+## Modules to Import
+
+```js
+import TestRunner from '@ohos.application.testRunner'
+```
+
+
+
+## TestRunner.onPrepare
+
+onPrepare(): void
+
+Prepares the unit test environment to run test cases.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Example**
+
+```js
+export default class UserTestRunner extends TestRunner {
+    onPrepare() {
+        console.log("Trigger onPrepare")
+    }
+};
+```
+
+
+
+## TestRunner.onRun
+
+onRun(): void
+
+Runs test cases.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Example**
+
+```js
+export default class UserTestRunner extends TestRunner {
+    onRun() {
+        console.log("Trigger onRun")
+    }
+};
+```