• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# ExtensionRunningInfo
2
3The **ExtensionRunningInfo** module provides APIs for setting and querying ExtensionAbility running information, which can be obtained through [getExtensionRunningInfos](js-apis-app-ability-abilityManager.md#getextensionrunninginfos).
4
5> **NOTE**
6>
7> 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.
8> The APIs of this module are system APIs and cannot be called by third-party applications.
9
10## Modules to Import
11
12```ts
13import abilityManager from '@ohos.app.ability.abilityManager';
14```
15
16## Usage
17
18The ExtensionAbility running information is obtained through an **abilityManager** instance.
19
20## Attributes
21
22**System capability**: SystemCapability.Ability.AbilityRuntime.Core
23
24| Name| Type| Readable| Writable| Description|
25| -------- | -------- | -------- | -------- | -------- |
26| extension | ElementName | Yes| No| ExtensionAbility information..|
27| pid | number | Yes| No| Process ID.|
28| uid | number | Yes| No| User ID.|
29| processName | string | Yes| No| Process name.|
30| startTime | number | Yes| No| Start time of the ExtensionAbility.|
31| clientPackage | Array<String> | Yes| No| Names of all packages in the process.|
32| type | [bundle.ExtensionAbilityType](js-apis-Bundle.md) | Yes| No| ExtensionAbility type.|
33
34**Example**
35```ts
36import abilityManager from '@ohos.application.abilityManager';
37let upperLimit = 1;
38abilityManager.getExtensionRunningInfos(upperLimit, (err,data) => {
39    console.log('getExtensionRunningInfos err: '  + err + ' data: ' + JSON.stringify(data));
40    for (let i = 0; i < data.length; i++) {
41        let extensionRunningInfo = data[i];
42        console.log('extensionRunningInfo.extension: ' + JSON.stringify(extensionRunningInfo.extension));
43        console.log('extensionRunningInfo.pid: ' + JSON.stringify(extensionRunningInfo.pid));
44        console.log('extensionRunningInfo.uid: ' + JSON.stringify(extensionRunningInfo.uid));
45        console.log('extensionRunningInfo.processName: ' + JSON.stringify(extensionRunningInfo.processName));
46        console.log('extensionRunningInfo.startTime: ' + JSON.stringify(extensionRunningInfo.startTime));
47        console.log('extensionRunningInfo.clientPackage: ' + JSON.stringify(extensionRunningInfo.clientPackage));
48        console.log('extensionRunningInfo.type: ' + JSON.stringify(extensionRunningInfo.type));
49    }
50});
51```
52