• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# ExtensionRunningInfo (System API)
2<!--Kit: Ability Kit-->
3<!--Subsystem: Ability-->
4<!--Owner: @yewei0794-->
5<!--Designer: @jsjzju-->
6<!--Tester: @lixueqing513-->
7<!--Adviser: @huipeizi-->
8
9The ExtensionRunningInfo module encapsulates ExtensionAbility running information, which can be obtained through [getExtensionRunningInfos](js-apis-app-ability-abilityManager-sys.md#getextensionrunninginfos).
10
11> **NOTE**
12>
13>  - 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.
14>  - The APIs provided by this module are system APIs.
15
16## Modules to Import
17
18```ts
19import { abilityManager } from '@kit.AbilityKit';
20```
21
22## Usage
23
24Import the abilityManager module and obtain the ExtensionAbility running information by calling the method in the abilityManager module.
25
26## Attributes
27
28**System capability**: SystemCapability.Ability.AbilityRuntime.Core
29
30**System API**: This is a system API.
31
32| Name| Type| Read-Only| Optional| Description|
33| -------- | -------- | -------- | -------- | -------- |
34| extension | [ElementName](js-apis-bundleManager-elementName.md) | No| No| ExtensionAbility information.|
35| pid | number | No| No| Process ID.|
36| uid | number | No| No| UID of the application.|
37| processName | string | No| No| Process name.|
38| startTime | number | No| No| Timestamp when the ExtensionAbility is started.|
39| clientPackage | Array&lt;String&gt; | No| No| Names of all packages in the process.|
40| type | [bundle.ExtensionAbilityType](js-apis-bundleManager.md#extensionabilitytype) | No| No| ExtensionAbility type.|
41
42**Example**
43```ts
44import { abilityManager } from '@kit.AbilityKit';
45
46let upperLimit = 1;
47
48function getExtensionInfos() {
49  abilityManager.getExtensionRunningInfos(upperLimit, (error, data) => {
50    if (error) {
51      console.error(`getForegroundApplications failed, error.code: ${JSON.stringify(error.code)}, error.message: ${JSON.stringify(error.message)}`);
52      return;
53    }
54
55    for (let i = 0; i < data.length; i++) {
56      let extensionRunningInfo = data[i];
57      console.info(`extensionRunningInfo.extension: ${JSON.stringify(extensionRunningInfo.extension)}`);
58      console.info(`extensionRunningInfo.pid: ${JSON.stringify(extensionRunningInfo.pid)}`);
59      console.info(`extensionRunningInfo.uid: ${JSON.stringify(extensionRunningInfo.uid)}`);
60      console.info(`extensionRunningInfo.processName: ${JSON.stringify(extensionRunningInfo.processName)}`);
61      console.info(`extensionRunningInfo.startTime: ${JSON.stringify(extensionRunningInfo.startTime)}`);
62      console.info(`extensionRunningInfo.clientPackage: ${JSON.stringify(extensionRunningInfo.clientPackage)}`);
63      console.info(`extensionRunningInfo.type: ${JSON.stringify(extensionRunningInfo.type)}`);
64    }
65  });
66}
67```
68