• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# ExtensionRunningInfo
2
3The **ExtensionRunningInfo** module encapsulates 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>  - This module is marked as @systemapi and not visible to third-party applications.
9
10## Modules to Import
11
12```ts
13import abilityManager from '@ohos.app.ability.abilityManager';
14```
15
16## Usage
17
18Import the **abilityManager** module and obtain the ExtensionAbility running information by calling the method in the **abilityManager** module.
19
20## Attributes
21
22**System capability**: SystemCapability.Ability.AbilityRuntime.Core
23
24**System API**: The following APIs are system APIs and cannot be called by third-party applications.
25
26| Name| Type| Readable| Writable| Description|
27| -------- | -------- | -------- | -------- | -------- |
28| extension | [ElementName](js-apis-bundleManager-elementName.md) | Yes| No| ExtensionAbility information.|
29| pid | number | Yes| No| Process ID.|
30| uid | number | Yes| No| UID of the application.|
31| processName | string | Yes| No| Process name.|
32| startTime | number | Yes| No| Timestamp when the ExtensionAbility is started.|
33| clientPackage | Array<String> | Yes| No| Names of all packages in the process.|
34| type | [ExtensionAbilityType](js-apis-bundleManager.md#extensionabilitytype) | Yes| No| ExtensionAbility type.|
35
36**Example**
37```ts
38import abilityManager from '@ohos.app.ability.abilityManager';
39
40let upperLimit = 1;
41function getExtensionInfos() {
42    abilityManager.getExtensionRunningInfos(upperLimit, (error, data) => {
43        if (error) {
44            console.error(`getForegroundApplications failed, error.code: ${JSON.stringify(error.code)}, error.message: ${JSON.stringify(error.message)}`);
45            return;
46        }
47
48        for (let i = 0; i < data.length; i++) {
49            let extensionRunningInfo = data[i];
50            console.log(`extensionRunningInfo.extension: ${JSON.stringify(extensionRunningInfo.extension)}`);
51            console.log(`extensionRunningInfo.pid: ${JSON.stringify(extensionRunningInfo.pid)}`);
52            console.log(`extensionRunningInfo.uid: ${JSON.stringify(extensionRunningInfo.uid)}`);
53            console.log(`extensionRunningInfo.processName: ${JSON.stringify(extensionRunningInfo.processName)}`);
54            console.log(`extensionRunningInfo.startTime: ${JSON.stringify(extensionRunningInfo.startTime)}`);
55            console.log(`extensionRunningInfo.clientPackage: ${JSON.stringify(extensionRunningInfo.clientPackage)}`);
56            console.log(`extensionRunningInfo.type: ${JSON.stringify(extensionRunningInfo.type)}`);
57        }
58    });
59}
60```
61