1# AbilityForegroundStateObserver (系统接口) 2 3定义应用前后台状态监听。 4 5> **说明：** 6> 7> 本模块首批接口从API version 11开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 8> 本模块接口为系统接口。 9 10## 导入模块 11 12```ts 13import abilityManager from '@ohos.app.ability.abilityManager'; 14``` 15 16## 属性 17 18**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core 19 20| 名称 | 类型 | 可读 | 可写 | 说明 | 21| -------------------------------- | ---------------------- | ---- | ---- | ------------------ | 22| onAbilityStateChanged | AsyncCallback\<void> | 是 | 否 | Ability前后台状态发生变化时执行的回调函数。传入参数类型是[AbilityStateData](js-apis-inner-application-appStateData-sys.md)。 | 23 24**示例：** 25```ts 26import abilityManager from '@ohos.app.ability.abilityManager'; 27import { BusinessError } from '@ohos.base'; 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}, ${message} `); 40} 41```