1# AbilityRunningInfo
2
3AbilityRunningInfo模块提供对Ability运行的相关信息和状态的定义。
4
5> **说明:**
6>
7> 本模块首批接口从API version 14开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
8
9## 导入模块
10
11```ts
12import { abilityManager } from '@kit.AbilityKit';
13```
14
15## 使用说明
16
17通过abilityManager中[getAbilityRunningInfos](js-apis-app-ability-abilityManager.md#getabilityrunninginfos)方法获取。
18
19## 属性
20
21**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
22
23| 名称 | 类型 | 可读 | 可写 | 说明 |
24| -------- | -------- | -------- | -------- | -------- |
25| ability | ElementName | 是 | 否 | Ability匹配信息  |
26| pid | number | 是 | 否 | 进程ID。 |
27| uid | number | 是 | 否 | 用户ID。  |
28| processName | string | 是 | 否 | 进程名称。  |
29| startTime | number | 是 | 否 | Ability启动时间。  |
30| abilityState | [abilityManager.AbilityState](js-apis-app-ability-abilityManager.md#abilitystate) | 是 | 否 | 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```