1# @ohos.application.missionManager (missionManager) 2 3missionManager模块提供系统任务管理能力，包括对系统任务执行锁定、解锁、清理、切换到前台等操作。 4 5> **说明：** 6> 7> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 8 9## 导入模块 10 11```ts 12import missionManager from '@ohos.application.missionManager'; 13``` 14 15## 权限列表 16 17ohos.permission.MANAGE_MISSIONS 18 19## missionManager.registerMissionListener 20 21registerMissionListener(listener: MissionListener): number; 22 23注册系统任务状态监听。 24 25**需要权限**：ohos.permission.MANAGE_MISSIONS 26 27**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 28 29**系统API**: 此接口为系统接口，三方应用不支持调用。 30 31**参数：** 32 33 | 参数名 | 类型 | 必填 | 说明 | 34 | -------- | -------- | -------- | -------- | 35 | listener | [MissionListener](js-apis-inner-application-missionListener.md) | 是 | 系统任务监听方法。 | 36 37**返回值：** 38 39 | 类型 | 说明 | 40 | -------- | -------- | 41 | number | 监听方法的index值，由系统创建，在注册系统任务状态监听时分配，和监听方法一一对应 。 | 42 43**示例：** 44 45```ts 46let listener = { 47 onMissionCreated: function (mission) {console.log('--------onMissionCreated-------');}, 48 onMissionDestroyed: function (mission) {console.log('--------onMissionDestroyed-------');}, 49 onMissionSnapshotChanged: function (mission) {console.log('--------onMissionSnapshotChanged-------');}, 50 onMissionMovedToFront: function (mission) {console.log('--------onMissionMovedToFront-------');}, 51 onMissionIconUpdated: function (mission, icon) {console.log('--------onMissionIconUpdated-------');}, 52 onMissionClosed: function (mission) {console.log('--------onMissionClosed-------');}, 53 onMissionLabelUpdated: function (mission) {console.log('--------onMissionLabelUpdated-------');} 54}; 55console.log('registerMissionListener'); 56let listenerid = missionManager.registerMissionListener(listener); 57``` 58 59 60## missionManager.unregisterMissionListener 61 62unregisterMissionListener(listenerId: number, callback: AsyncCallback<void>): void; 63 64取消任务状态监听。 65 66**需要权限**：ohos.permission.MANAGE_MISSIONS 67 68**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 69 70**系统API**: 此接口为系统接口，三方应用不支持调用。 71 72**参数：** 73 74 | 参数名 | 类型 | 必填 | 说明 | 75 | -------- | -------- | -------- | -------- | 76 | listenerId | number | 是 | 系统任务状态监听方法的index值，和监听方法一一对应，由registerMissionListener方法返回。 | 77 | callback | AsyncCallback<void> | 是 | 执行结果回调函数。 | 78 79**示例：** 80 81```ts 82 let listener = { 83 onMissionCreated: function (mission) {console.log('--------onMissionCreated-------');}, 84 onMissionDestroyed: function (mission) {console.log('--------onMissionDestroyed-------');}, 85 onMissionSnapshotChanged: function (mission) {console.log('--------onMissionSnapshotChanged-------');}, 86 onMissionMovedToFront: function (mission) {console.log('--------onMissionMovedToFront-------');}, 87 onMissionIconUpdated: function (mission, icon) {console.log('--------onMissionIconUpdated-------');}, 88 onMissionClosed: function (mission) {console.log('--------onMissionClosed-------');}, 89 onMissionLabelUpdated: function (mission) {console.log('--------onMissionLabelUpdated-------');} 90 }; 91 console.log('registerMissionListener'); 92 let listenerid = missionManager.registerMissionListener(listener); 93 94 missionManager.unregisterMissionListener(listenerid, (error) => { 95 console.log('unregisterMissionListener'); 96 }); 97``` 98 99 100## missionManager.unregisterMissionListener 101 102unregisterMissionListener(listenerId: number): Promise<void>; 103 104取消任务状态监听，以promise方式返回执行结果。 105 106**需要权限**：ohos.permission.MANAGE_MISSIONS 107 108**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 109 110**系统API**: 此接口为系统接口，三方应用不支持调用。 111 112**参数：** 113 114 | 参数名 | 类型 | 必填 | 说明 | 115 | -------- | -------- | -------- | -------- | 116 | listenerId | number | 是 | 系统任务状态监听方法的index值，和监听方法一一对应，由registerMissionListener方法返回。 | 117 118**返回值：** 119 120 | 类型 | 说明 | 121 | -------- | -------- | 122 | Promise<void> | promise方式返回执行结果。 | 123 124**示例：** 125 126```ts 127 let listener = { 128 onMissionCreated: function (mission) {console.log('--------onMissionCreated-------');}, 129 onMissionDestroyed: function (mission) {console.log('--------onMissionDestroyed-------');}, 130 onMissionSnapshotChanged: function (mission) {console.log('--------onMissionSnapshotChanged-------');}, 131 onMissionMovedToFront: function (mission) {console.log('--------onMissionMovedToFront-------');}, 132 onMissionIconUpdated: function (mission, icon) {console.log('--------onMissionIconUpdated-------');}, 133 onMissionClosed: function (mission) {console.log('--------onMissionClosed-------');}, 134 onMissionLabelUpdated: function (mission) {console.log('--------onMissionLabelUpdated-------');} 135 }; 136 console.log('registerMissionListener'); 137 let listenerid = missionManager.registerMissionListener(listener); 138 139 missionManager.unregisterMissionListener(listenerid).catch(function (err) { 140 console.log(err); 141 }); 142``` 143 144 145## missionManager.getMissionInfo 146 147getMissionInfo(deviceId: string, missionId: number, callback: AsyncCallback<MissionInfo>): void; 148 149获取任务信息，以异步回调的方式返回任务信息。 150 151**需要权限**：ohos.permission.MANAGE_MISSIONS 152 153**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 154 155**系统API**: 此接口为系统接口，三方应用不支持调用。 156 157**参数：** 158 159 | 参数名 | 类型 | 必填 | 说明 | 160 | -------- | -------- | -------- | -------- | 161 | deviceId | string | 是 | 设备ID，本机默认为空字符串。 | 162 | missionId | number | 是 | 任务ID。 | 163 | callback | AsyncCallback<[MissionInfo](js-apis-inner-application-missionInfo.md)> | 是 | 执行结果回调函数，返回任务信息。 | 164 165**示例：** 166 167 ```ts 168 import missionManager from '@ohos.application.missionManager' 169 170 let allMissions=missionManager.getMissionInfos('',10).catch(function(err){console.log(err);}); 171 missionManager.getMissionInfo('', allMissions[0].missionId, (error, mission) => { 172 console.log('getMissionInfo is called, error.code = ' + error.code) 173 console.log('mission.missionId = ' + mission.missionId); 174 console.log('mission.runningState = ' + mission.runningState); 175 console.log('mission.lockedState = ' + mission.lockedState); 176 console.log('mission.timestamp = ' + mission.timestamp); 177 console.log('mission.label = ' + mission.label); 178 console.log('mission.iconPath = ' + mission.iconPath); 179 }); 180 ``` 181 182 183## missionManager.getMissionInfo 184 185getMissionInfo(deviceId: string, missionId: number): Promise<MissionInfo>; 186 187获取任务信息，以promise方式返回任务信息。 188 189**需要权限**：ohos.permission.MANAGE_MISSIONS 190 191**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 192 193**系统API**: 此接口为系统接口，三方应用不支持调用。 194 195**参数：** 196 197 | 参数名 | 类型 | 必填 | 说明 | 198 | -------- | -------- | -------- | -------- | 199 | deviceId | string | 是 | 设备ID，本机默认为空字符串。 | 200 | missionId | number | 是 | 任务ID。 | 201 202**返回值：** 203 204 | 类型 | 说明 | 205 | -------- | -------- | 206 | Promise<[MissionInfo](js-apis-inner-application-missionInfo.md)> | 任务信息。 | 207 208**示例：** 209 210 ```ts 211 import missionManager from '@ohos.application.missionManager'; 212 213 let mission = missionManager.getMissionInfo('', 10).catch(function (err){ 214 console.log(err); 215 }); 216 ``` 217 218 219## missionManager.getMissionInfos 220 221getMissionInfos(deviceId: string, numMax: number, callback: AsyncCallback<Array<MissionInfo>>): void; 222 223获取所有任务信息，以回调函数的方式返回任务信息数组。 224 225**需要权限**：ohos.permission.MANAGE_MISSIONS 226 227**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 228 229**系统API**: 此接口为系统接口，三方应用不支持调用。 230 231**参数：** 232 233 | 参数名 | 类型 | 必填 | 说明 | 234 | -------- | -------- | -------- | -------- | 235 | deviceId | string | 是 | 设备ID，本机默认为空字符串。 | 236 | numMax | number | 是 | 任务信息数量上限。 | 237 | callback | AsyncCallback<Array<[MissionInfo](js-apis-inner-application-missionInfo.md)>> | 是 | 执行结果回调函数，返回任务信息数组。 | 238 239**示例：** 240 241 ```ts 242 import missionManager from '@ohos.application.missionManager'; 243 244 missionManager.getMissionInfos('', 10, (error, missions) => { 245 console.log('getMissionInfos is called, error.code = ' + error.code); 246 console.log('size = ' + missions.length); 247 console.log('missions = ' + JSON.stringify(missions)); 248 }); 249 ``` 250 251 252## missionManager.getMissionInfos 253 254getMissionInfos(deviceId: string, numMax: number): Promise<Array<MissionInfo>>; 255 256获取所有任务信息，以promise的方式返回任务信息数组。 257 258**需要权限**：ohos.permission.MANAGE_MISSIONS 259 260**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 261 262**系统API**: 此接口为系统接口，三方应用不支持调用。 263 264**参数：** 265 266 | 参数名 | 类型 | 必填 | 说明 | 267 | -------- | -------- | -------- | -------- | 268 | deviceId | string | 是 | 设备ID，本机默认为空字符串。 | 269 | numMax | number | 是 | 任务信息数量上限。 | 270 271**返回值：** 272 273 | 类型 | 说明 | 274 | -------- | -------- | 275 | Promise<Array<[MissionInfo](js-apis-inner-application-missionInfo.md)>> | 任务信息数组。 | 276 277**示例：** 278 279 ```ts 280 import missionManager from '@ohos.application.missionManager'; 281 282 let allMissions = missionManager.getMissionInfos('', 10).catch(function (err){ 283 console.log(err); 284 }); 285 ``` 286 287 288## missionManager.getMissionSnapShot 289 290getMissionSnapShot(deviceId: string, missionId: number, callback: AsyncCallback<MissionSnapshot>): void; 291 292获取任务快照，以回调函数的方式返回快照内容。 293 294**需要权限**：ohos.permission.MANAGE_MISSIONS 295 296**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 297 298**系统API**: 此接口为系统接口，三方应用不支持调用。 299 300**参数：** 301 302 | 参数名 | 类型 | 必填 | 说明 | 303 | -------- | -------- | -------- | -------- | 304 | deviceId | string | 是 | 设备ID，本机默认为空字符串。 | 305 | missionId | number | 是 | 任务ID。 | 306 | callback | AsyncCallback<[MissionSnapshot](js-apis-inner-application-missionSnapshot.md)> | 是 | 执行结果回调函数，返回任务快照信息。 | 307 308**示例：** 309 310 ```ts 311 import missionManager from '@ohos.application.missionManager'; 312 313 missionManager.getMissionInfos('', 10, (error, missions) => { 314 console.log('getMissionInfos is called, error.code = ' + error.code); 315 console.log('size = ' + missions.length); 316 console.log('missions = ' + JSON.stringify(missions)); 317 let id = missions[0].missionId; 318 319 missionManager.getMissionSnapShot('', id, (error, snapshot) => { 320 console.log('getMissionSnapShot is called, error.code = ' + error.code); 321 console.log('bundleName = ' + snapshot.ability.bundleName); 322 }); 323 }); 324 ``` 325 326 327## missionManager.getMissionSnapShot 328 329getMissionSnapShot(deviceId: string, missionId: number): Promise<MissionSnapshot>; 330 331获取任务快照，以promise的方式返回快照内容。 332 333**需要权限**：ohos.permission.MANAGE_MISSIONS 334 335**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 336 337**系统API**: 此接口为系统接口，三方应用不支持调用。 338 339**参数：** 340 341 | 参数名 | 类型 | 必填 | 说明 | 342 | -------- | -------- | -------- | -------- | 343 | deviceId | string | 是 | 设备ID，本机默认为空字符串。 | 344 | missionId | number | 是 | 任务ID。 | 345 346**返回值：** 347 348 | 类型 | 说明 | 349 | -------- | -------- | 350 | Promise<[MissionSnapshot](js-apis-inner-application-missionSnapshot.md)> | 任务快照信息。 | 351 352**示例：** 353 354 ```ts 355 import missionManager from '@ohos.application.missionManager'; 356 357 let allMissions; 358 missionManager.getMissionInfos('',10).then(function(res){ 359 allMissions=res; 360 }).catch(function(err){console.log(err);}); 361 console.log('size = ' + allMissions.length); 362 console.log('missions = ' + JSON.stringify(allMissions)); 363 let id = allMissions[0].missionId; 364 365 let snapshot = missionManager.getMissionSnapShot('', id).catch(function (err){ 366 console.log(err); 367 }); 368 ``` 369 370## missionManager.lockMission 371 372lockMission(missionId: number, callback: AsyncCallback<void>): void; 373 374锁定指定任务id的任务，以回调函数的方式返回。 375 376**需要权限**：ohos.permission.MANAGE_MISSIONS 377 378**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 379 380**系统API**: 此接口为系统接口，三方应用不支持调用。 381 382**参数：** 383 384 | 参数名 | 类型 | 必填 | 说明 | 385 | -------- | -------- | -------- | -------- | 386 | missionId | number | 是 | 任务ID。 | 387 | callback | AsyncCallback<void> | 是 | 执行结果回调函数。 | 388 389**示例：** 390 391 ```ts 392 import missionManager from '@ohos.application.missionManager'; 393 394 missionManager.getMissionInfos('', 10, (error, missions) => { 395 console.log('getMissionInfos is called, error.code = ' + error.code); 396 console.log('size = ' + missions.length); 397 console.log('missions = ' + JSON.stringify(missions)); 398 let id = missions[0].missionId; 399 400 missionManager.lockMission(id).then(() => { 401 console.log('lockMission is called '); 402 }); 403 }); 404 ``` 405 406 407## missionManager.lockMission 408 409lockMission(missionId: number): Promise<void>; 410 411锁定指定任务id的任务，以promise方式返回。 412 413**需要权限**：ohos.permission.MANAGE_MISSIONS 414 415**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 416 417**系统API**: 此接口为系统接口，三方应用不支持调用。 418 419**参数：** 420 421 | 参数名 | 类型 | 必填 | 说明 | 422 | -------- | -------- | -------- | -------- | 423 | missionId | number | 是 | 任务ID。 | 424 425**返回值：** 426 427 | 类型 | 说明 | 428 | -------- | -------- | 429 | Promise<void> | promise方式返回执行结果。 | 430 431**示例：** 432 433 ```ts 434 import missionManager from '@ohos.application.missionManager'; 435 let allMissions; 436 missionManager.getMissionInfos('',10).then(function(res){ 437 allMissions=res; 438 }).catch(function(err){console.log(err);}); 439 console.log('size = ' + allMissions.length); 440 console.log('missions = ' + JSON.stringify(allMissions)); 441 let id = allMissions[0].missionId; 442 443 missionManager.lockMission(id).catch(function (err){ 444 console.log(err); 445 }); 446 ``` 447 448 449## missionManager.unlockMission 450 451unlockMission(missionId: number, callback: AsyncCallback<void>): void; 452 453解锁指定任务id的任务，以回调函数的方式返回。 454 455**需要权限**：ohos.permission.MANAGE_MISSIONS 456 457**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 458 459**系统API**: 此接口为系统接口，三方应用不支持调用。 460 461**参数：** 462 463| 参数名 | 类型 | 必填 | 说明 | 464| -------- | -------- | -------- | -------- | 465| missionId | number | 是 | 任务ID。 | 466| callback | AsyncCallback<void> | 是 | 执行结果回调函数。 | 467 468**示例：** 469 470 ```ts 471 import missionManager from '@ohos.application.missionManager'; 472 473 missionManager.getMissionInfos('', 10, (error, missions) => { 474 console.log('getMissionInfos is called, error.code = ' + error.code); 475 console.log('size = ' + missions.length); 476 console.log('missions = ' + JSON.stringify(missions)); 477 let id = missions[0].missionId; 478 479 missionManager.unlockMission(id).then(() => { 480 console.log('unlockMission is called '); 481 }); 482 }); 483 ``` 484 485 486## missionManager.unlockMission 487 488unlockMission(missionId: number): Promise<void>; 489 490解锁指定任务id的任务，以promise的方式返回。 491 492**需要权限**：ohos.permission.MANAGE_MISSIONS 493 494**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 495 496**系统API**: 此接口为系统接口，三方应用不支持调用。 497 498**参数：** 499 500 | 参数名 | 类型 | 必填 | 说明 | 501 | -------- | -------- | -------- | -------- | 502 | missionId | number | 是 | 任务ID。 | 503 504**返回值：** 505 506 | 类型 | 说明 | 507 | -------- | -------- | 508 | Promise<void> | promise方式返回执行结果。 | 509 510**示例：** 511 512 ```ts 513 import missionManager from '@ohos.application.missionManager'; 514 515 let allMissions; 516 missionManager.getMissionInfos('',10).then(function(res){ 517 allMissions=res; 518 }).catch(function(err){console.log(err);}); 519 console.log('size = ' + allMissions.length); 520 console.log('missions = ' + JSON.stringify(allMissions)); 521 let id = allMissions[0].missionId; 522 523 missionManager.lockMission(id).catch(function (err){ 524 console.log(err); 525 }); 526 missionManager.unlockMission(id).catch(function (err){ 527 console.log(err); 528 }); 529 ``` 530 531 532## missionManager.clearMission 533 534clearMission(missionId: number, callback: AsyncCallback<void>): void; 535 536清理指定任务id的任务，无论该任务是否被锁定，以回调函数的方式返回。 537 538**需要权限**：ohos.permission.MANAGE_MISSIONS 539 540**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 541 542**系统API**: 此接口为系统接口，三方应用不支持调用。 543 544**参数：** 545 546 | 参数名 | 类型 | 必填 | 说明 | 547 | -------- | -------- | -------- | -------- | 548 | missionId | number | 是 | 任务ID。 | 549 | callback | AsyncCallback<void> | 是 | 执行结果回调函数。 | 550 551**示例：** 552 553 ```ts 554 import missionManager from '@ohos.application.missionManager'; 555 556 missionManager.getMissionInfos('', 10, (error, missions) => { 557 console.log('getMissionInfos is called, error.code = ' + error.code); 558 console.log('size = ' + missions.length); 559 console.log('missions = ' + JSON.stringify(missions)); 560 let id = missions[0].missionId; 561 562 missionManager.clearMission(id).then(() => { 563 console.log('clearMission is called '); 564 }); 565 }); 566 ``` 567 568 569## missionManager.clearMission 570 571clearMission(missionId: number): Promise<void>; 572 573清理指定任务id的任务，无论该任务是否被锁定，以promise的方式返回。 574 575**需要权限**：ohos.permission.MANAGE_MISSIONS 576 577**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 578 579**系统API**: 此接口为系统接口，三方应用不支持调用。 580 581**参数：** 582 583 | 参数名 | 类型 | 必填 | 说明 | 584 | -------- | -------- | -------- | -------- | 585 | missionId | number | 是 | 任务ID。 | 586 587**返回值：** 588 589 | 类型 | 说明 | 590 | -------- | -------- | 591 | Promise<void> | promise方式返回执行结果。 | 592 593**示例：** 594 595 ```ts 596 import missionManager from '@ohos.application.missionManager'; 597 598 let allMissions; 599 missionManager.getMissionInfos('',10).then(function(res){ 600 allMissions=res; 601 }).catch(function(err){console.log(err);}); 602 console.log('size = ' + allMissions.length); 603 console.log('missions = ' + JSON.stringify(allMissions)); 604 let id = allMissions[0].missionId; 605 606 missionManager.clearMission(id).catch(function (err){ 607 console.log(err); 608 }); 609 ``` 610 611 612## missionManager.clearAllMissions 613 614clearAllMissions(callback: AsyncCallback<void>): void; 615 616清理所有未锁定的任务，以回调函数的方式返回。 617 618**需要权限**：ohos.permission.MANAGE_MISSIONS 619 620**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 621 622**系统API**: 此接口为系统接口，三方应用不支持调用。 623 624**示例：** 625 626 ```ts 627 import missionManager from '@ohos.application.missionManager'; 628 629 missionManager.clearAllMissions().then(() => { 630 console.log('clearAllMissions is called '); 631 }); 632 ``` 633 634 635## missionManager.clearAllMissions 636 637clearAllMissions(): Promise<void>; 638 639清理所有未锁定的任务，以promise的方式返回。 640 641**需要权限**：ohos.permission.MANAGE_MISSIONS 642 643**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 644 645**系统API**: 此接口为系统接口，三方应用不支持调用。 646 647**返回值：** 648 649 | 类型 | 说明 | 650 | -------- | -------- | 651 | Promise<void> | promise方式返回执行结果。 | 652 653**示例：** 654 655 ```ts 656 import missionManager from '@ohos.application.missionManager'; 657 missionManager.clearAllMissions().catch(function (err){ 658 console.log(err); 659 }); 660 ``` 661 662 663## missionManager.moveMissionToFront 664 665moveMissionToFront(missionId: number, callback: AsyncCallback<void>): void; 666 667把指定任务id的任务切到前台，以回调函数的方式返回。 668 669**需要权限**：ohos.permission.MANAGE_MISSIONS 670 671**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 672 673**系统API**: 此接口为系统接口，三方应用不支持调用。 674 675**参数：** 676 677 | 参数名 | 类型 | 必填 | 说明 | 678 | -------- | -------- | -------- | -------- | 679 | missionId | number | 是 | 任务ID。 | 680 | callback | AsyncCallback<void> | 是 | 执行结果回调函数。 | 681 682**示例：** 683 684 ```ts 685 import missionManager from '@ohos.application.missionManager'; 686 687 missionManager.getMissionInfos('', 10, (error, missions) => { 688 console.log('getMissionInfos is called, error.code = ' + error.code); 689 console.log('size = ' + missions.length); 690 console.log('missions = ' + JSON.stringify(missions)); 691 let id = missions[0].missionId; 692 693 missionManager.moveMissionToFront(id).then(() => { 694 console.log('moveMissionToFront is called '); 695 }); 696 }); 697 ``` 698 699 700## missionManager.moveMissionToFront 701 702moveMissionToFront(missionId: number, options: StartOptions, callback: AsyncCallback<void>): void; 703 704把指定任务id的任务切到前台，同时指定任务切换到前台时的启动参数，例如窗口模式、设备ID等，以回调函数的方式返回。 705 706**需要权限**：ohos.permission.MANAGE_MISSIONS 707 708**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 709 710**系统API**: 此接口为系统接口，三方应用不支持调用。 711 712**参数：** 713 714 | 参数名 | 类型 | 必填 | 说明 | 715 | -------- | -------- | -------- | -------- | 716 | missionId | number | 是 | 任务ID。 | 717 | options | [StartOptions](js-apis-app-ability-startOptions.md) | 是 | 启动参数选项，用于指定任务切到前台时的窗口模式，设备ID等。 | 718 | callback | AsyncCallback<void> | 是 | 执行结果回调函数。 | 719 720**示例：** 721 722 ```ts 723 import missionManager from '@ohos.application.missionManager'; 724 725 missionManager.getMissionInfos('', 10, (error, missions) => { 726 console.log('getMissionInfos is called, error.code = ' + error.code); 727 console.log('size = ' + missions.length); 728 console.log('missions = ' + JSON.stringify(missions)); 729 let id = missions[0].missionId; 730 731 missionManager.moveMissionToFront(id,{windowMode : 101}).then(() => { 732 console.log('moveMissionToFront is called '); 733 }); 734 }); 735 ``` 736 737 738## missionManager.moveMissionToFront 739 740moveMissionToFront(missionId: number, options?: StartOptions): Promise<void>; 741 742把指定任务id的任务切到前台，同时指定任务切换到前台时的启动参数，例如窗口模式、设备ID等，以promise的方式返回。 743 744**需要权限**：ohos.permission.MANAGE_MISSIONS 745 746**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 747 748**系统API**: 此接口为系统接口，三方应用不支持调用。 749 750**参数：** 751 752 | 参数名 | 类型 | 必填 | 说明 | 753 | -------- | -------- | -------- | -------- | 754 | missionId | number | 是 | 任务ID。 | 755 | options | [StartOptions](js-apis-app-ability-startOptions.md) | 否 | 启动参数选项，用于指定任务切到前台时的窗口模式，设备ID等。 | 756 757**返回值：** 758 759 | 类型 | 说明 | 760 | -------- | -------- | 761 | Promise<void> | promise方式返回执行结果。 | 762 763**示例：** 764 765 ```ts 766 import missionManager from '@ohos.application.missionManager'; 767 768 let allMissions; 769 missionManager.getMissionInfos('',10).then(function(res){ 770 allMissions=res; 771 }).catch(function(err){console.log(err);}); 772 console.log('size = ' + allMissions.length); 773 console.log('missions = ' + JSON.stringify(allMissions)); 774 let id = allMissions[0].missionId; 775 776 missionManager.moveMissionToFront(id).catch(function (err){ 777 console.log(err); 778 }); 779 ```