1# @ohos.app.ability.abilityManager (AbilityManager)
2
3AbilityManager模块提供获取Ability相关信息和运行状态信息的能力。
4
5> **说明：**
6>
7> 本模块首批接口从API version 14开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
8
9## 导入模块
10
11```ts
12import { abilityManager } from '@kit.AbilityKit';
13```
14
15
16## AbilityState
17
18Ability的状态，该类型为枚举，可配合[AbilityRunningInfo](js-apis-inner-application-abilityRunningInfo.md)返回Ability的状态。
19
20**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
21
22| 名称 | 值 | 说明 |
23| -------- | -------- | -------- |
24| INITIAL | 0 | 表示ability为初始化状态。|
25| FOCUS | 2 | 表示ability为获焦状态。 |
26| FOREGROUND | 9 | 表示ability为前台状态。  |
27| BACKGROUND | 10 | 表示ability为后台状态。  |
28| FOREGROUNDING | 11 | 表示ability为前台调度中状态。  |
29| BACKGROUNDING | 12 | 表示ability为后台调度中状态。  |
30
31
32## getAbilityRunningInfos
33
34getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>>
35
36获取UIAbility运行相关信息（Promise形式）。
37
38**需要权限**：ohos.permission.GET_RUNNING_INFO
39
40**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
41
42**返回值：**
43
44| 类型                                       | 说明      |
45| ---------------------------------------- | ------- |
46| Promise\<Array\<[AbilityRunningInfo](js-apis-inner-application-abilityRunningInfo.md)>> | 以Promise方式返回接口运行结果及运行中的ability信息，可进行错误处理或其他自定义处理。 |
47
48**错误码**：
49
50以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。
51
52| 错误码ID | 错误信息 |
53| ------- | -------- |
54| 16000050 | Internal error. |
55
56**示例**：
57
58```ts
59import { abilityManager } from '@kit.AbilityKit';
60import { BusinessError } from '@kit.BasicServicesKit';
61
62try {
63  abilityManager.getAbilityRunningInfos()
64    .then((data: abilityManager.AbilityRunningInfo[]) => {
65      console.log(`getAbilityRunningInfos success, data: ${JSON.stringify(data)}`);
66    })
67    .catch((error: BusinessError) => {
68      console.error(`getAbilityRunningInfos fail, error code: ${JSON.stringify(error.code)}, error msg: ${JSON.stringify(error.message)}`);
69    })
70} catch (e) {
71  let code = (e as BusinessError).code;
72  let msg = (e as BusinessError).message;
73  console.error(`getAbilityRunningInfos fail, error code: ${JSON.stringify(code)}, error msg: ${JSON.stringify(msg)}`);
74}
75```