1# AbilityRunningInfo (系统接口)
2
3AbilityRunningInfo模块提供对Ability运行的相关信息和状态的定义。
4
5> **说明:**
6> 
7> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
8> 本模块接口为系统接口。
9
10## 导入模块
11
12```ts
13import { abilityManager } from '@kit.AbilityKit';
14```
15
16## 使用说明
17
18通过abilityManager中[getAbilityRunningInfos](js-apis-app-ability-abilityManager-sys.md#getabilityrunninginfos)方法获取。
19
20## 属性
21
22**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
23
24**系统API**:该接口为系统接口,三方应用不支持调用。
25
26| 名称 | 类型 | 可读 | 可写 | 说明 |
27| -------- | -------- | -------- | -------- | -------- |
28| ability | ElementName | 是 | 否 | Ability匹配信息  |
29| pid | number | 是 | 否 | 进程ID。 |
30| uid | number | 是 | 否 | 用户ID。  |
31| processName | string | 是 | 否 | 进程名称。  |
32| startTime | number | 是 | 否 | Ability启动时间。  |
33| abilityState | [abilityManager.AbilityState](js-apis-app-ability-abilityManager-sys.md#abilitystate) | 是 | 否 | Ability状态。  |
34
35**示例:**
36
37```ts
38import { abilityManager } from '@kit.AbilityKit';
39
40abilityManager.getAbilityRunningInfos((error, data) => {
41  if (error) {
42    console.error(`getAbilityRunningInfos fail, error: ${JSON.stringify(error)}`);
43  } else {
44    console.log(`getAbilityRunningInfos success, data: ${JSON.stringify(data)}`);
45    for (let i = 0; i < data.length; i++) {
46      let abilityInfo = data[i];
47      console.log(`abilityInfo.ability: ${JSON.stringify(abilityInfo.ability)}`);
48      console.log(`abilityInfo.pid: ${JSON.stringify(abilityInfo.pid)}`);
49      console.log(`abilityInfo.uid: ${JSON.stringify(abilityInfo.uid)}`);
50      console.log(`abilityInfo.processName: ${JSON.stringify(abilityInfo.processName)}`);
51      console.log(`abilityInfo.startTime: ${JSON.stringify(abilityInfo.startTime)}`);
52      console.log(`abilityInfo.abilityState: ${JSON.stringify(abilityInfo.abilityState)}`);
53    }
54  }
55});
56```