1# @ohos.application.missionManager (missionManager) 2 3The **missionManager** module provides APIs to lock, unlock, and clear missions, and switch a mission to the foreground. 4 5> **NOTE** 6> 7> The APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version. 8 9## Modules to Import 10 11```ts 12import missionManager from '@ohos.application.missionManager'; 13``` 14 15## Required Permissions 16 17ohos.permission.MANAGE_MISSIONS 18 19## missionManager.registerMissionListener 20 21registerMissionListener(listener: MissionListener): number; 22 23Registers a listener to observe the mission status. 24 25**Required permissions**: ohos.permission.MANAGE_MISSIONS 26 27**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 28 29**System API**: This is a system API and cannot be called by third-party applications. 30 31**Parameters** 32 33 | Name| Type| Mandatory| Description| 34 | -------- | -------- | -------- | -------- | 35 | listener | [MissionListener](js-apis-inner-application-missionListener.md) | Yes| Mission status listener to register.| 36 37**Return value** 38 39 | Type| Description| 40 | -------- | -------- | 41 | number | Index of the mission status listener, which is created by the system and allocated when the listener is registered.| 42 43**Example** 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 64Deregisters a mission status listener. This API uses an asynchronous callback to return the result. 65 66**Required permissions**: ohos.permission.MANAGE_MISSIONS 67 68**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 69 70**System API**: This is a system API and cannot be called by third-party applications. 71 72**Parameters** 73 74 | Name| Type| Mandatory| Description| 75 | -------- | -------- | -------- | -------- | 76 | listenerId | number | Yes| Index of the mission status listener to deregister. It is returned by **registerMissionListener()**.| 77 | callback | AsyncCallback<void> | Yes| Callback used to return the result.| 78 79**Example** 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 104Deregisters a mission status listener. This API uses a promise to return the result. 105 106**Required permissions**: ohos.permission.MANAGE_MISSIONS 107 108**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 109 110**System API**: This is a system API and cannot be called by third-party applications. 111 112**Parameters** 113 114 | Name| Type| Mandatory| Description| 115 | -------- | -------- | -------- | -------- | 116 | listenerId | number | Yes| Index of the mission status listener to deregister. It is returned by **registerMissionListener()**.| 117 118**Return value** 119 120 | Type| Description| 121 | -------- | -------- | 122 | Promise<void> | Promise used to return the result.| 123 124**Example** 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 149Obtains the information about a given mission. This API uses an asynchronous callback to return the result. 150 151**Required permissions**: ohos.permission.MANAGE_MISSIONS 152 153**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 154 155**System API**: This is a system API and cannot be called by third-party applications. 156 157**Parameters** 158 159 | Name| Type| Mandatory| Description| 160 | -------- | -------- | -------- | -------- | 161 | deviceId | string | Yes| Device ID. It is a null string by default for the local device.| 162 | missionId | number | Yes| Mission ID.| 163 | callback | AsyncCallback<[MissionInfo](js-apis-inner-application-missionInfo.md)> | Yes| Callback used to return the mission information obtained.| 164 165**Example** 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 187Obtains the information about a given mission. This API uses a promise to return the result. 188 189**Required permissions**: ohos.permission.MANAGE_MISSIONS 190 191**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 192 193**System API**: This is a system API and cannot be called by third-party applications. 194 195**Parameters** 196 197 | Name| Type| Mandatory| Description| 198 | -------- | -------- | -------- | -------- | 199 | deviceId | string | Yes| Device ID. It is a null string by default for the local device.| 200 | missionId | number | Yes| Mission ID.| 201 202**Return value** 203 204 | Type| Description| 205 | -------- | -------- | 206 | Promise<[MissionInfo](js-apis-inner-application-missionInfo.md)> | Promise used to return the mission information obtained.| 207 208**Example** 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 223Obtains information about all missions. This API uses an asynchronous callback to return the result. 224 225**Required permissions**: ohos.permission.MANAGE_MISSIONS 226 227**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 228 229**System API**: This is a system API and cannot be called by third-party applications. 230 231**Parameters** 232 233 | Name| Type| Mandatory| Description| 234 | -------- | -------- | -------- | -------- | 235 | deviceId | string | Yes| Device ID. It is a null string by default for the local device.| 236 | numMax | number | Yes| Maximum number of missions whose information can be obtained.| 237 | callback | AsyncCallback<Array<[MissionInfo](js-apis-inner-application-missionInfo.md)>> | Yes| Callback used to return the array of mission information obtained.| 238 239**Example** 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 256Obtains information about all missions. This API uses a promise to return the result. 257 258**Required permissions**: ohos.permission.MANAGE_MISSIONS 259 260**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 261 262**System API**: This is a system API and cannot be called by third-party applications. 263 264**Parameters** 265 266 | Name| Type| Mandatory| Description| 267 | -------- | -------- | -------- | -------- | 268 | deviceId | string | Yes| Device ID. It is a null string by default for the local device.| 269 | numMax | number | Yes| Maximum number of missions whose information can be obtained.| 270 271**Return value** 272 273 | Type| Description| 274 | -------- | -------- | 275 | Promise<Array<[MissionInfo](js-apis-inner-application-missionInfo.md)>> | Promise used to return the array of mission information obtained.| 276 277**Example** 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 292Obtains the snapshot of a given mission. This API uses an asynchronous callback to return the result. 293 294**Required permissions**: ohos.permission.MANAGE_MISSIONS 295 296**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 297 298**System API**: This is a system API and cannot be called by third-party applications. 299 300**Parameters** 301 302 | Name| Type| Mandatory| Description| 303 | -------- | -------- | -------- | -------- | 304 | deviceId | string | Yes| Device ID. It is a null string by default for the local device.| 305 | missionId | number | Yes| Mission ID.| 306 | callback | AsyncCallback<[MissionSnapshot](js-apis-inner-application-missionSnapshot.md)> | Yes| Callback used to return the snapshot information obtained.| 307 308**Example** 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 331Obtains the snapshot of a given mission. This API uses a promise to return the result. 332 333**Required permissions**: ohos.permission.MANAGE_MISSIONS 334 335**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 336 337**System API**: This is a system API and cannot be called by third-party applications. 338 339**Parameters** 340 341 | Name| Type| Mandatory| Description| 342 | -------- | -------- | -------- | -------- | 343 | deviceId | string | Yes| Device ID. It is a null string by default for the local device.| 344 | missionId | number | Yes| Mission ID.| 345 346**Return value** 347 348 | Type| Description| 349 | -------- | -------- | 350 | Promise<[MissionSnapshot](js-apis-inner-application-missionSnapshot.md)> | Promise used to return the snapshot information obtained.| 351 352**Example** 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 374Locks a given mission. This API uses an asynchronous callback to return the result. 375 376**Required permissions**: ohos.permission.MANAGE_MISSIONS 377 378**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 379 380**System API**: This is a system API and cannot be called by third-party applications. 381 382**Parameters** 383 384 | Name| Type| Mandatory| Description| 385 | -------- | -------- | -------- | -------- | 386 | missionId | number | Yes| Mission ID.| 387 | callback | AsyncCallback<void> | Yes| Callback used to return the result.| 388 389**Example** 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 411Locks a given mission. This API uses a promise to return the result. 412 413**Required permissions**: ohos.permission.MANAGE_MISSIONS 414 415**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 416 417**System API**: This is a system API and cannot be called by third-party applications. 418 419**Parameters** 420 421 | Name| Type| Mandatory| Description| 422 | -------- | -------- | -------- | -------- | 423 | missionId | number | Yes| Mission ID.| 424 425**Return value** 426 427 | Type| Description| 428 | -------- | -------- | 429 | Promise<void> | Promise used to return the result.| 430 431**Example** 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 453Unlocks a given mission. This API uses an asynchronous callback to return the result. 454 455**Required permissions**: ohos.permission.MANAGE_MISSIONS 456 457**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 458 459**System API**: This is a system API and cannot be called by third-party applications. 460 461**Parameters** 462 463| Name| Type| Mandatory| Description| 464| -------- | -------- | -------- | -------- | 465| missionId | number | Yes| Mission ID.| 466| callback | AsyncCallback<void> | Yes| Callback used to return the result.| 467 468**Example** 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 490Unlocks a given mission. This API uses a promise to return the result. 491 492**Required permissions**: ohos.permission.MANAGE_MISSIONS 493 494**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 495 496**System API**: This is a system API and cannot be called by third-party applications. 497 498**Parameters** 499 500 | Name| Type| Mandatory| Description| 501 | -------- | -------- | -------- | -------- | 502 | missionId | number | Yes| Mission ID.| 503 504**Return value** 505 506 | Type| Description| 507 | -------- | -------- | 508 | Promise<void> | Promise used to return the result.| 509 510**Example** 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 536Clears a given mission, regardless of whether it is locked. This API uses an asynchronous callback to return the result. 537 538**Required permissions**: ohos.permission.MANAGE_MISSIONS 539 540**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 541 542**System API**: This is a system API and cannot be called by third-party applications. 543 544**Parameters** 545 546 | Name| Type| Mandatory| Description| 547 | -------- | -------- | -------- | -------- | 548 | missionId | number | Yes| Mission ID.| 549 | callback | AsyncCallback<void> | Yes| Callback used to return the result.| 550 551**Example** 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 573Clears a given mission, regardless of whether it is locked. This API uses a promise to return the result. 574 575**Required permissions**: ohos.permission.MANAGE_MISSIONS 576 577**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 578 579**System API**: This is a system API and cannot be called by third-party applications. 580 581**Parameters** 582 583 | Name| Type| Mandatory| Description| 584 | -------- | -------- | -------- | -------- | 585 | missionId | number | Yes| Mission ID.| 586 587**Return value** 588 589 | Type| Description| 590 | -------- | -------- | 591 | Promise<void> | Promise used to return the result.| 592 593**Example** 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 616Clears all unlocked missions. This API uses an asynchronous callback to return the result. 617 618**Required permissions**: ohos.permission.MANAGE_MISSIONS 619 620**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 621 622**System API**: This is a system API and cannot be called by third-party applications. 623 624**Example** 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 639Clears all unlocked missions. This API uses a promise to return the result. 640 641**Required permissions**: ohos.permission.MANAGE_MISSIONS 642 643**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 644 645**System API**: This is a system API and cannot be called by third-party applications. 646 647**Return value** 648 649 | Type| Description| 650 | -------- | -------- | 651 | Promise<void> | Promise used to return the result.| 652 653**Example** 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 667Switches a given mission to the foreground. This API uses an asynchronous callback to return the result. 668 669**Required permissions**: ohos.permission.MANAGE_MISSIONS 670 671**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 672 673**System API**: This is a system API and cannot be called by third-party applications. 674 675**Parameters** 676 677 | Name| Type| Mandatory| Description| 678 | -------- | -------- | -------- | -------- | 679 | missionId | number | Yes| Mission ID.| 680 | callback | AsyncCallback<void> | Yes| Callback used to return the result.| 681 682**Example** 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 704Switches a given mission to the foreground, with the startup parameters for the switching specified. This API uses an asynchronous callback to return the result. 705 706**Required permissions**: ohos.permission.MANAGE_MISSIONS 707 708**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 709 710**System API**: This is a system API and cannot be called by third-party applications. 711 712**Parameters** 713 714 | Name| Type| Mandatory| Description| 715 | -------- | -------- | -------- | -------- | 716 | missionId | number | Yes| Mission ID.| 717 | options | [StartOptions](js-apis-app-ability-startOptions.md) | Yes| Startup parameters, which are used to specify the window mode and device ID for switching the mission to the foreground.| 718 | callback | AsyncCallback<void> | Yes| Callback used to return the result.| 719 720**Example** 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 742Switches a given mission to the foreground, with the startup parameters for the switching specified. This API uses a promise to return the result. 743 744**Required permissions**: ohos.permission.MANAGE_MISSIONS 745 746**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 747 748**System API**: This is a system API and cannot be called by third-party applications. 749 750**Parameters** 751 752 | Name| Type| Mandatory| Description| 753 | -------- | -------- | -------- | -------- | 754 | missionId | number | Yes| Mission ID.| 755 | options | [StartOptions](js-apis-app-ability-startOptions.md) | No| Startup parameters, which are used to specify the window mode and device ID for switching the mission to the foreground.| 756 757**Return value** 758 759 | Type| Description| 760 | -------- | -------- | 761 | Promise<void> | Promise used to return the result.| 762 763**Example** 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 ``` 780