1# MissionSnapshot (系统接口)
2
3一个任务的任务快照对象，可以通过[missionManager.getMissionSnapShot](js-apis-app-ability-missionManager-sys.md#missionmanagergetmissionsnapshot)获取。
4
5> **说明：**
6>
7> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
8> 本模块接口均为系统接口，三方应用不支持调用。
9
10## 导入模块
11
12```ts
13import { missionManager } from '@kit.AbilityKit';
14```
15
16## 属性
17
18**系统接口**：此接口为系统接口。
19
20**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
21
22| 名称 | 类型 | 可读 | 可写 | 说明 |
23| -------- | -------- | -------- | -------- | -------- |
24| ability | ElementName | 是 | 是 | 表示该任务的组件信息。 |
25| snapshot | [PixelMap](../apis-image-kit/js-apis-image.md#pixelmap7) | 是 | 是 | 表示任务快照。 |
26
27## 使用说明
28
29通过missionManager中的getMissionSnapShot来获取。
30
31**示例：**
32```ts
33import { missionManager } from '@kit.AbilityKit';
34import { BusinessError } from '@kit.BasicServicesKit';
35
36try {
37  missionManager.getMissionInfos('', 10, (error, missions) => {
38    if (error) {
39      console.error(`getMissionInfos failed, error.code: ${JSON.stringify(error.code)}, error.message: ${JSON.stringify(error.message)}`);
40      return;
41    }
42    console.log(`size = ${missions.length}`);
43    console.log(`missions = ${JSON.stringify(missions)}`);
44    let id = missions[0].missionId;
45
46    missionManager.getMissionSnapShot('', id, (err, snapshot) => {
47      if (err) {
48        console.error(`getMissionInfos failed, err.code: ${JSON.stringify(err.code)}, err.message: ${JSON.stringify(err.message)}`);
49        return;
50      }
51      // 执行正常业务
52      console.log(`bundleName = ${snapshot.ability.bundleName}`);
53    });
54  });
55} catch (paramError) {
56  console.error(`error: ${(paramError as BusinessError).code}, ${(paramError as BusinessError).message}`);
57}
58```