1# AbilityForegroundStateObserver (系统接口)
2
3定义应用前后台状态监听。
4
5> **说明：**
6>
7> 本模块首批接口从API version 11开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
8> 本模块接口为系统接口。
9
10## 导入模块
11
12```ts
13import { abilityManager } from '@kit.AbilityKit';
14```
15
16## 属性
17
18**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
19
20| 名称                             | 类型                    | 可读 | 可写 | 说明   |
21| -------------------------------- | ---------------------- | ---- | ---- | ------------------ |
22| onAbilityStateChanged   | AsyncCallback\<void>   | 是   | 否   | Ability前后台状态发生变化时执行的回调函数。传入参数类型是[AbilityStateData](js-apis-inner-application-abilityStateData.md)。 |
23
24**示例：**
25```ts
26import { abilityManager } from '@kit.AbilityKit';
27import { BusinessError } from '@kit.BasicServicesKit';
28
29let observer: abilityManager.AbilityForegroundStateObserver = {
30  onAbilityStateChanged(abilityStateData) {
31    console.log(`onAbilityStateChanged: ${JSON.stringify(abilityStateData)}`);
32  },
33};
34try {
35  abilityManager.on('abilityForegroundState', observer);
36} catch (paramError) {
37  let code = (paramError as BusinessError).code;
38  let message = (paramError as BusinessError).message;
39  console.error(`error code: ${code}, error msg: ${message}`);
40}
41```
42