• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# MissionInfo
2
3表示任务的详细信息，可以通过[getMissionInfo](js-apis-app-ability-missionManager.md#missionmanagergetmissioninfo)获取。
4
5> **说明：**
6>
7> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
8
9## 导入模块
10
11```ts
12import missionManager from '@ohos.app.ability.missionManager';
13```
14
15## 属性
16
17**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Mission
18
19**系统API**: 此接口为系统接口，三方应用不支持调用。
20
21| 名称 | 类型 | 可读 | 可写 | 说明 |
22| -------- | -------- | -------- | -------- | -------- |
23| missionId | number | 是 | 是 | 表示任务ID。|
24| runningState | number | 是 | 是 | 表示运行状态。 |
25| lockedState | boolean | 是 | 是 | 表示锁定状态。 |
26| timestamp | string | 是 | 是 | 表示任务的最近创建或更新时间。 |
27| want | [Want](js-apis-application-want.md) | 是 | 是 | 表示任务的Want信息。 |
28| label | string | 是 | 是 | 表示任务的标签。 |
29| iconPath | string | 是 | 是 | 表示任务的图标路径。 |
30| continuable | boolean | 是 | 是 | 表示任务是否可以迁移。 |
31| abilityState<sup>10+</sup> | number | 是 | 是 | 表示此任务的能力状态。 |
32| unclearable<sup>10+</sup> | boolean | 是 | 是 | 表示任务是否可以被用户手动删除。 |
33
34**示例：**
35```ts
36import missionManager from '@ohos.app.ability.missionManager';
37
38try {
39  missionManager.getMissionInfo('', 1, (error, data) => {
40    if (error) {
41        // 处理业务逻辑错误
42        console.error(`getMissionInfo failed, error.code: ${error.code}, error.message: ${error.message}`);
43        return;
44    }
45
46    console.log(`getMissionInfo missionId is: ${JSON.stringify(data.missionId)}`);
47    console.log(`getMissionInfo runningState is: ${JSON.stringify(data.runningState)}`);
48    console.log(`getMissionInfo lockedState is: ${JSON.stringify(data.lockedState)}`);
49    console.log(`getMissionInfo timestamp is: ${JSON.stringify(data.timestamp)}`);
50    console.log(`getMissionInfo want is: ${JSON.stringify(data.want)}`);
51    console.log(`getMissionInfo label is: ${JSON.stringify(data.label)}`);
52    console.log(`getMissionInfo iconPath is: ${JSON.stringify(data.iconPath)}`);
53    console.log(`getMissionInfo continuable is: ${JSON.stringify(data.continuable)}`);
54    console.log(`getMissionInfo unclearable is: ${JSON.stringify(data.unclearable)}`);
55    });
56} catch (paramError) {
57    console.error(`error: ${paramError.code}, ${paramError.message}`);
58}
59```