• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# ExtensionRunningInfo (系统接口)
2<!--Kit: Ability Kit-->
3<!--Subsystem: Ability-->
4<!--Owner: @yewei0794-->
5<!--Designer: @jsjzju-->
6<!--Tester: @lixueqing513-->
7<!--Adviser: @huipeizi-->
8
9ExtensionRunningInfo模块封装了Extension运行的相关信息,可以通过[getExtensionRunningInfos接口](js-apis-app-ability-abilityManager-sys.md#getextensionrunninginfos)获取。
10
11> **说明:**
12>
13>  - 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
14>  - 本模块接口为系统接口。
15
16## 导入模块
17
18```ts
19import { abilityManager } from '@kit.AbilityKit';
20```
21
22## 使用说明
23
24导入abilityManager模块,通过调用abilityManager中的方法获取ExtensionRunningInfo。
25
26## 属性
27
28**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
29
30**系统接口**:此接口为系统接口。
31
32| 名称 | 类型 | 只读 | 可选 | 说明 |
33| -------- | -------- | -------- | -------- | -------- |
34| extension | [ElementName](js-apis-bundleManager-elementName.md) | 否 | 否 | Extension信息。 |
35| pid | number | 否 | 否 | 进程ID。 |
36| uid | number | 否 | 否 | 应用程序的uid。 |
37| processName | string | 否 | 否 | 进程名称。 |
38| startTime | number | 否 | 否 | Extension被启动时的时间戳。 |
39| clientPackage | Array&lt;String&gt; | 否 | 否 | 表示当期进程下的所有包名。 |
40| type | [bundle.ExtensionAbilityType](js-apis-bundleManager.md#extensionabilitytype) | 否 | 否 | Extension类型。 |
41
42**示例:**
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