• 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.application.abilityManager';
38abilitymanager.getAbilityRunningInfos((err,data) => {
39    console.log('getAbilityRunningInfos err: '  + err + ' data: ' + JSON.stringify(data));
40    for (let i = 0; i < data.length; i++) {
41        let abilityinfo = data[i];
42        console.log('abilityinfo.ability: ' + JSON.stringify(abilityinfo.ability));
43        console.log('abilityinfo.pid: ' + JSON.stringify(abilityinfo.pid));
44        console.log('abilityinfo.uid: ' + JSON.stringify(abilityinfo.uid));
45        console.log('abilityinfo.processName: ' + JSON.stringify(abilityinfo.processName));
46        console.log('abilityinfo.startTime: ' + JSON.stringify(abilityinfo.startTime));
47        console.log('abilityinfo.abilityState: ' + JSON.stringify(abilityinfo.abilityState));
48    }
49});
50```
51