1 # AppStateData 2 3定义应用状态信息,可以通过[getForegroundApplications](js-apis-app-ability-appManager.md#appmanagergetforegroundapplications)获取当前应用的相关信息。 4 5> **说明:** 6> 7> 本模块首批接口从API version 8 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 8 9## 导入模块 10 11```ts 12import appManager from '@ohos.app.ability.appManager'; 13``` 14 15## 属性 16 17**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core 18 19**系统API**:本模块被标记为@systemapi,对三方应用隐藏 20 21| 名称 | 类型 | 必填 | 说明 | 22| ------------------------- | ------ | ---- | --------- | 23| bundleName<sup>8+</sup> | string | 否 | Bundle名称。 | 24| uid<sup>8+</sup> | number | 否 | 应用程序的uid。 | 25| state<sup>8+</sup> | number | 否 | 应用状态。<br>0:初始化状态,应用正在初始化<br>1:就绪状态,应用已初始化完毕<br>2:前台状态,应用位于前台<br>3:获焦状态。(预留状态,当前暂不支持)<br>4:后台状态,应用位于后台<br>5:退出状态,应用已退出 | 26 27**示例:** 28 29```ts 30import appManager from '@ohos.app.ability.appManager'; 31 32function getForegroundAppInfos() { 33 appManager.getForegroundApplications((error, data) => { 34 if (error) { 35 console.log(`getForegroundApplications failed, error.code: ${JSON.stringify(error.code)}, error.message: ${JSON.stringify(error.message)}`); 36 return; 37 } 38 for (let i = 0; i < data.length; i++) { 39 let appStateData = data[i]; 40 console.log(`appStateData.bundleName: ${appStateData.bundleName}`); 41 console.log(`appStateData.uid: ${appStateData.uid}`); 42 console.log(`appStateData.state: ${appStateData.state}`); 43 } 44 }); 45} 46``` 47