• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# AbilityRunningInfo
2
3The **AbilityRunningInfo** module defines the running information and state of an ability.
4
5> **NOTE**
6>
7> 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.
8
9## Modules to Import
10
11```ts
12import abilitymanager from '@ohos.app.ability.abilityManager';
13```
14
15## Usage
16
17The ability running information is obtained by calling [getAbilityRunningInfos](js-apis-app-ability-abilityManager.md#getabilityrunninginfos) in **abilityManager**.
18
19## Attributes
20
21**System capability**: SystemCapability.Ability.AbilityRuntime.Core
22
23**System API**: This is a system API and cannot be called by third-party applications.
24
25| Name| Type| Readable| Writable| Description|
26| -------- | -------- | -------- | -------- | -------- |
27| ability | ElementName | Yes| No| Information that matches an ability. |
28| pid | number | Yes| No| Process ID.|
29| uid | number | Yes| No| User ID. |
30| processName | string | Yes| No| Process name. |
31| startTime | number | Yes| No| Ability start time. |
32| abilityState | [abilityManager.AbilityState](js-apis-app-ability-abilityManager.md#abilitystate) | Yes| No| Ability state. |
33
34**Example**
35
36```ts
37import abilitymanager from '@ohos.app.ability.abilityManager';
38
39abilitymanager.getAbilityRunningInfos((error, data) => {
40    if (error) {
41        console.error(`getAbilityRunningInfos fail, error: ${JSON.stringify(error)}`);
42    } else {
43        console.log(`getAbilityRunningInfos success, data: ${JSON.stringify(data)}`);
44        for (let i = 0; i < data.length; i++) {
45            let abilityinfo = data[i];
46            console.log(`abilityinfo.ability: ${JSON.stringify(abilityinfo.ability)}`);
47            console.log(`abilityinfo.pid: ${JSON.stringify(abilityinfo.pid)}`);
48            console.log(`abilityinfo.uid: ${JSON.stringify(abilityinfo.uid)}`);
49            console.log(`abilityinfo.processName: ${JSON.stringify(abilityinfo.processName)}`);
50            console.log(`abilityinfo.startTime: ${JSON.stringify(abilityinfo.startTime)}`);
51            console.log(`abilityinfo.abilityState: ${JSON.stringify(abilityinfo.abilityState)}`);
52        }
53    }
54});
55```
56