• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# AbilityRunningInfo
2<!--Kit: Ability Kit-->
3<!--Subsystem: Ability-->
4<!--Owner: @zhu-feimo-->
5<!--Designer: @ccllee1-->
6<!--Tester: @lixueqing513-->
7<!--Adviser: @huipeizi-->
8AbilityRunningInfo是记录Ability运行信息和状态的数据结构，通过[getAbilityRunningInfos](js-apis-app-ability-abilityManager.md#abilitymanagergetabilityrunninginfos14)方法获取。
9> **说明：**
10>
11> 本模块首批接口从API version 14开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
12
13## 导入模块
14
15```ts
16import { abilityManager } from '@kit.AbilityKit';
17```
18
19## AbilityRunningInfo
20
21**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
22
23| 名称 | 类型 | 只读 | 可选 | 说明 |
24| -------- | -------- | -------- | -------- | -------- |
25| ability | [ElementName](../apis-ability-kit/js-apis-bundleManager-elementName.md) | 否 | 否 | Ability的ElementName信息。 |
26| pid | number | 否 | 否 | 进程ID。 |
27| uid | number | 否 | 否 | 所属应用程序的UID。  |
28| processName | string | 否 | 否 | 进程的名称。  |
29| startTime | number | 否 | 否 |Ability的启动时间。 |
30| abilityState | [abilityManager.AbilityState](js-apis-app-ability-abilityManager.md#abilitystate14) | 否 | 否 | Ability的状态。  |
31
32**示例：**
33
34```ts
35import { abilityManager } from '@kit.AbilityKit';
36import { BusinessError } from '@kit.BasicServicesKit';
37
38try {
39  abilityManager.getAbilityRunningInfos()
40    .then((data: abilityManager.AbilityRunningInfo[]) => {
41      for (let i = 0; i < data.length; i++) {
42        let abilityInfo = data[i];
43        console.info(`getAbilityRunningInfos success, data: ${JSON.stringify(abilityInfo)}`);
44      }
45    })
46    .catch((error: BusinessError) => {
47      console.error(`getAbilityRunningInfos fail, error code: ${JSON.stringify(error.code)}, error msg: ${JSON.stringify(error.message)}`);
48    })
49} catch (e) {
50  let code = (e as BusinessError).code;
51  let msg = (e as BusinessError).message;
52  console.error(`getAbilityRunningInfos fail, error code: ${JSON.stringify(code)}, error msg: ${JSON.stringify(msg)}`);
53}
54```