js-apis-inner-application-abilityRunningInfo.md

# AbilityRunningInfo

AbilityRunningInfo模块提供对Ability运行的相关信息和状态的定义。

> **说明：**
> 
> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

## 使用说明

通过abilityManager中[getAbilityRunningInfos](js-apis-app-ability-abilityManager.md#getabilityrunninginfos)方法获取。

## 属性

**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core

**系统API**：该接口为系统接口，三方应用不支持调用。

| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| ability | ElementName | 是 | 否 | Ability匹配信息  |
| pid | number | 是 | 否 | 进程ID。 |
| uid | number | 是 | 否 | 用户ID。  |
| processName | string | 是 | 否 | 进程名称。  |
| startTime | number | 是 | 否 | Ability启动时间。  |
| abilityState | [abilityManager.AbilityState](js-apis-app-ability-abilityManager.md#abilitystate) | 是 | 否 | Ability状态。  |

**示例：**

```ts
import abilitymanager from '@ohos.app.ability.abilityManager';

abilitymanager.getAbilityRunningInfos((error, data) => { 
    if (error && error.code !== 0) {
        console.error('getAbilityRunningInfos fail, error: ${JSON.stringify(error)}');
    } else {
        console.log('getAbilityRunningInfos success, data: ${JSON.stringify(data)}');
        for (let i = 0; i < data.length; i++) {
            let abilityinfo = data[i];
            console.log('abilityinfo.ability: ${JSON.stringify(abilityinfo.ability)}');
            console.log('abilityinfo.pid: ${JSON.stringify(abilityinfo.pid)}');
            console.log('abilityinfo.uid: ${JSON.stringify(abilityinfo.uid)}');
            console.log('abilityinfo.processName: ${JSON.stringify(abilityinfo.processName)}');
            console.log('abilityinfo.startTime: ${JSON.stringify(abilityinfo.startTime)}');
            console.log('abilityinfo.abilityState: ${JSON.stringify(abilityinfo.abilityState)}');
        }
    }
});
```