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 and deprecated since API version 9. You are advised to use [@ohos.app.ability.missionManager](js-apis-app-ability-missionManager.md) instead. 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 46import missionManager from '@ohos.application.missionManager'; 47 48console.log('registerMissionListener'); 49let listenerid = missionManager.registerMissionListener({ 50 onMissionCreated: (mission) => {console.log('--------onMissionCreated-------');}, 51 onMissionDestroyed: (mission) => {console.log('--------onMissionDestroyed-------');}, 52 onMissionSnapshotChanged: (mission) => {console.log('--------onMissionSnapshotChanged-------');}, 53 onMissionMovedToFront: (mission) => {console.log('--------onMissionMovedToFront-------');}, 54 onMissionIconUpdated: (mission, icon) => {console.log('--------onMissionIconUpdated-------');}, 55 onMissionClosed: (mission) => {console.log('--------onMissionClosed-------');}, 56 onMissionLabelUpdated: (mission) => {console.log('--------onMissionLabelUpdated-------');} 57}); 58``` 59 60 61## missionManager.unregisterMissionListener 62 63unregisterMissionListener(listenerId: number, callback: AsyncCallback<void>): void; 64 65Deregisters a mission status listener. This API uses an asynchronous callback to return the result. 66 67**Required permissions**: ohos.permission.MANAGE_MISSIONS 68 69**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 70 71**System API**: This is a system API and cannot be called by third-party applications. 72 73**Parameters** 74 75 | Name| Type| Mandatory| Description| 76 | -------- | -------- | -------- | -------- | 77 | listenerId | number | Yes| Index of the mission status listener to deregister. It is returned by **registerMissionListener()**.| 78 | callback | AsyncCallback<void> | Yes| Callback used to return the result.| 79 80**Example** 81 82```ts 83 import missionManager from '@ohos.application.missionManager'; 84 85 console.log('registerMissionListener'); 86 let listenerid = missionManager.registerMissionListener({ 87 onMissionCreated: (mission) => {console.log('--------onMissionCreated-------');}, 88 onMissionDestroyed: (mission) => {console.log('--------onMissionDestroyed-------');}, 89 onMissionSnapshotChanged: (mission) => {console.log('--------onMissionSnapshotChanged-------');}, 90 onMissionMovedToFront: (mission) => {console.log('--------onMissionMovedToFront-------');}, 91 onMissionIconUpdated: (mission, icon) => {console.log('--------onMissionIconUpdated-------');}, 92 onMissionClosed: (mission) => {console.log('--------onMissionClosed-------');}, 93 onMissionLabelUpdated: (mission) => {console.log('--------onMissionLabelUpdated-------');} 94 }); 95 96 missionManager.unregisterMissionListener(listenerid, (error) => { 97 console.error('unregisterMissionListener fail, error: ${error}'); 98 }); 99``` 100 101 102## missionManager.unregisterMissionListener 103 104unregisterMissionListener(listenerId: number): Promise<void>; 105 106Deregisters a mission status listener. This API uses a promise to return the result. 107 108**Required permissions**: ohos.permission.MANAGE_MISSIONS 109 110**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 111 112**System API**: This is a system API and cannot be called by third-party applications. 113 114**Parameters** 115 116 | Name| Type| Mandatory| Description| 117 | -------- | -------- | -------- | -------- | 118 | listenerId | number | Yes| Index of the mission status listener to deregister. It is returned by **registerMissionListener()**.| 119 120**Return value** 121 122 | Type| Description| 123 | -------- | -------- | 124 | Promise<void> | Promise used to return the result.| 125 126**Example** 127 128```ts 129 import missionManager from '@ohos.application.missionManager'; 130 import { BusinessError } from '@ohos.base'; 131 132 console.log('registerMissionListener'); 133 let listenerid = missionManager.registerMissionListener({ 134 onMissionCreated: (mission) => {console.log('--------onMissionCreated-------');}, 135 onMissionDestroyed: (mission) => {console.log('--------onMissionDestroyed-------');}, 136 onMissionSnapshotChanged: (mission) => {console.log('--------onMissionSnapshotChanged-------');}, 137 onMissionMovedToFront: (mission) => {console.log('--------onMissionMovedToFront-------');}, 138 onMissionIconUpdated: (mission, icon) => {console.log('--------onMissionIconUpdated-------');}, 139 onMissionClosed: (mission) => {console.log('--------onMissionClosed-------');}, 140 onMissionLabelUpdated: (mission) => {console.log('--------onMissionLabelUpdated-------');} 141 }); 142 143 missionManager.unregisterMissionListener(listenerid).catch((error: BusinessError) => { 144 console.error('unregisterMissionListener fail, error: ${error}'); 145 }); 146``` 147 148 149## missionManager.getMissionInfo 150 151getMissionInfo(deviceId: string, missionId: number, callback: AsyncCallback<MissionInfo>): void; 152 153Obtains the information about a given mission. This API uses an asynchronous callback to return the result. 154 155**Required permissions**: ohos.permission.MANAGE_MISSIONS 156 157**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 158 159**System API**: This is a system API and cannot be called by third-party applications. 160 161**Parameters** 162 163 | Name| Type| Mandatory| Description| 164 | -------- | -------- | -------- | -------- | 165 | deviceId | string | Yes| Device ID. It is a null string by default for the local device.| 166 | missionId | number | Yes| Mission ID.| 167 | callback | AsyncCallback<[MissionInfo](js-apis-inner-application-missionInfo.md)> | Yes| Callback used to return the mission information obtained.| 168 169**Example** 170 171 ```ts 172 import missionManager from '@ohos.application.missionManager'; 173 import { BusinessError } from '@ohos.base'; 174 175 let allMissions=missionManager.getMissionInfos('',10).catch((err: BusinessError) => { 176 console.log('${err}');}); 177 missionManager.getMissionInfo('', allMissions[0].missionId, (error, mission) => { 178 if (error.code) { 179 console.error('getMissionInfo failed, error.code: ${error.code}, error.message: ${error.message}'); 180 return; 181 } 182 183 console.log('mission.missionId = ${mission.missionId}'); 184 console.log('mission.runningState = ${mission.runningState}'); 185 console.log('mission.lockedState = ${mission.lockedState}'); 186 console.log('mission.timestamp = ${mission.timestamp}'); 187 console.log('mission.label = ${mission.label}'); 188 console.log('mission.iconPath = ${mission.iconPath}'); 189 }); 190 ``` 191 192 193## missionManager.getMissionInfo 194 195getMissionInfo(deviceId: string, missionId: number): Promise<MissionInfo>; 196 197Obtains the information about a given mission. This API uses a promise to return the result. 198 199**Required permissions**: ohos.permission.MANAGE_MISSIONS 200 201**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 202 203**System API**: This is a system API and cannot be called by third-party applications. 204 205**Parameters** 206 207 | Name| Type| Mandatory| Description| 208 | -------- | -------- | -------- | -------- | 209 | deviceId | string | Yes| Device ID. It is a null string by default for the local device.| 210 | missionId | number | Yes| Mission ID.| 211 212**Return value** 213 214 | Type| Description| 215 | -------- | -------- | 216 | Promise<[MissionInfo](js-apis-inner-application-missionInfo.md)> | Promise used to return the mission information obtained.| 217 218**Example** 219 220 ```ts 221 import missionManager from '@ohos.application.missionManager'; 222 import { BusinessError } from '@ohos.base'; 223 224 let mission = missionManager.getMissionInfo('', 10).catch((error: BusinessError) => { 225 console.error('getMissionInfo fail, error: ${error}'); 226 }); 227 ``` 228 229 230## missionManager.getMissionInfos 231 232getMissionInfos(deviceId: string, numMax: number, callback: AsyncCallback<Array<MissionInfo>>): void; 233 234Obtains information about all missions. This API uses an asynchronous callback to return the result. 235 236**Required permissions**: ohos.permission.MANAGE_MISSIONS 237 238**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 239 240**System API**: This is a system API and cannot be called by third-party applications. 241 242**Parameters** 243 244 | Name| Type| Mandatory| Description| 245 | -------- | -------- | -------- | -------- | 246 | deviceId | string | Yes| Device ID. It is a null string by default for the local device.| 247 | numMax | number | Yes| Maximum number of missions whose information can be obtained.| 248 | callback | AsyncCallback<Array<[MissionInfo](js-apis-inner-application-missionInfo.md)>> | Yes| Callback used to return the array of mission information obtained.| 249 250**Example** 251 252 ```ts 253 import missionManager from '@ohos.application.missionManager'; 254 255 missionManager.getMissionInfos('', 10, (error, missions) => { 256 if (error.code) { 257 console.error(`getMissionInfos failed, error.code: ${error.code}, error.message: ${error.message}`); 258 return; 259 } 260 console.log(`size = ${missions.length}`); 261 console.log(`missions = ${JSON.stringify(missions)}`); 262 }); 263 ``` 264 265 266## missionManager.getMissionInfos 267 268getMissionInfos(deviceId: string, numMax: number): Promise<Array<MissionInfo>>; 269 270Obtains information about all missions. This API uses a promise to return the result. 271 272**Required permissions**: ohos.permission.MANAGE_MISSIONS 273 274**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 275 276**System API**: This is a system API and cannot be called by third-party applications. 277 278**Parameters** 279 280 | Name| Type| Mandatory| Description| 281 | -------- | -------- | -------- | -------- | 282 | deviceId | string | Yes| Device ID. It is a null string by default for the local device.| 283 | numMax | number | Yes| Maximum number of missions whose information can be obtained.| 284 285**Return value** 286 287 | Type| Description| 288 | -------- | -------- | 289 | Promise<Array<[MissionInfo](js-apis-inner-application-missionInfo.md)>> | Promise used to return the array of mission information obtained.| 290 291**Example** 292 293 ```ts 294 import missionManager from '@ohos.application.missionManager'; 295 import { BusinessError } from '@ohos.base'; 296 297 let allMissions = missionManager.getMissionInfos('', 10).catch((error: BusinessError) => { 298 console.error('getMissionInfos fail, error: ${error}'); 299 }); 300 ``` 301 302 303## missionManager.getMissionSnapShot 304 305getMissionSnapShot(deviceId: string, missionId: number, callback: AsyncCallback<MissionSnapshot>): void; 306 307Obtains the snapshot of a given mission. This API uses an asynchronous callback to return the result. 308 309**Required permissions**: ohos.permission.MANAGE_MISSIONS 310 311**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 312 313**System API**: This is a system API and cannot be called by third-party applications. 314 315**Parameters** 316 317 | Name| Type| Mandatory| Description| 318 | -------- | -------- | -------- | -------- | 319 | deviceId | string | Yes| Device ID. It is a null string by default for the local device.| 320 | missionId | number | Yes| Mission ID.| 321 | callback | AsyncCallback<[MissionSnapshot](js-apis-inner-application-missionSnapshot.md)> | Yes| Callback used to return the snapshot information obtained.| 322 323**Example** 324 325 ```ts 326 import missionManager from '@ohos.application.missionManager'; 327 328 missionManager.getMissionInfos('', 10, (error, missions) => { 329 if (error.code) { 330 console.error(`getMissionInfos failed, error.code: ${error.code}, error.message: ${error.message}`); 331 return; 332 } 333 console.log(`size = ${missions.length}`); 334 console.log(`missions = ${JSON.stringify(missions)}`); 335 let id = missions[0].missionId; 336 337 missionManager.getMissionSnapShot('', id, (error, snapshot) => { 338 if (error.code) { 339 console.error(`getMissionSnapShot failed, error.code: ${error.code}, error.message: ${error.message}`); 340 return; 341 } 342 console.log(`bundleName = ${snapshot.ability.bundleName}`); 343 }); 344 }); 345 ``` 346 347 348## missionManager.getMissionSnapShot 349 350getMissionSnapShot(deviceId: string, missionId: number): Promise<MissionSnapshot>; 351 352Obtains the snapshot of a given mission. This API uses a promise to return the result. 353 354**Required permissions**: ohos.permission.MANAGE_MISSIONS 355 356**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 357 358**System API**: This is a system API and cannot be called by third-party applications. 359 360**Parameters** 361 362 | Name| Type| Mandatory| Description| 363 | -------- | -------- | -------- | -------- | 364 | deviceId | string | Yes| Device ID. It is a null string by default for the local device.| 365 | missionId | number | Yes| Mission ID.| 366 367**Return value** 368 369 | Type| Description| 370 | -------- | -------- | 371 | Promise<[MissionSnapshot](js-apis-inner-application-missionSnapshot.md)> | Promise used to return the snapshot information obtained.| 372 373**Example** 374 375 ```ts 376 import missionManager from '@ohos.application.missionManager'; 377 import { BusinessError } from '@ohos.base'; 378 379 let id: number = -1; 380 missionManager.getMissionInfos('',10).then((res) => { 381 let allMissions = res; 382 console.log(`size = ${allMissions.length}`); 383 console.log(`missions = ${JSON.stringify(allMissions)}`); 384 id = allMissions[0].missionId; 385 }).catch((error: BusinessError) => { 386 console.error(`getMissionInfos fail, error: ${error}`); 387 }); 388 389 let snapshot = missionManager.getMissionSnapShot('', id).catch((error: BusinessError) => { 390 console.error(`getMissionSnapShot fail, error: ${error}`); 391 }); 392 ``` 393 394## missionManager.lockMission 395 396lockMission(missionId: number, callback: AsyncCallback<void>): void; 397 398Locks a given mission. This API uses an asynchronous callback to return the result. 399 400**Required permissions**: ohos.permission.MANAGE_MISSIONS 401 402**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 403 404**System API**: This is a system API and cannot be called by third-party applications. 405 406**Parameters** 407 408 | Name| Type| Mandatory| Description| 409 | -------- | -------- | -------- | -------- | 410 | missionId | number | Yes| Mission ID.| 411 | callback | AsyncCallback<void> | Yes| Callback used to return the result.| 412 413**Example** 414 415 ```ts 416 import missionManager from '@ohos.application.missionManager'; 417 418 missionManager.getMissionInfos('', 10, (error, missions) => { 419 if (error.code) { 420 console.error(`getMissionInfos failed, error.code: ${error.code}, error.message: ${error.message}`); 421 return; 422 } 423 console.log(`size = ${missions.length}`); 424 console.log(`missions = ${JSON.stringify(missions)}`); 425 let id = missions[0].missionId; 426 427 missionManager.lockMission(id).then(() => { 428 console.log('lockMission is called '); 429 }); 430 }); 431 ``` 432 433 434## missionManager.lockMission 435 436lockMission(missionId: number): Promise<void>; 437 438Locks a given mission. This API uses a promise to return the result. 439 440**Required permissions**: ohos.permission.MANAGE_MISSIONS 441 442**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 443 444**System API**: This is a system API and cannot be called by third-party applications. 445 446**Parameters** 447 448 | Name| Type| Mandatory| Description| 449 | -------- | -------- | -------- | -------- | 450 | missionId | number | Yes| Mission ID.| 451 452**Return value** 453 454 | Type| Description| 455 | -------- | -------- | 456 | Promise<void> | Promise used to return the result.| 457 458**Example** 459 460 ```ts 461 import missionManager from '@ohos.application.missionManager'; 462 import { BusinessError } from '@ohos.base'; 463 464 let id: number = -1; 465 missionManager.getMissionInfos('',10).then((res) => { 466 let allMissions = res; 467 console.log(`size = ${allMissions.length}`); 468 console.log(`missions = ${JSON.stringify(allMissions)}`); 469 id = allMissions[0].missionId; 470 }).catch((error: BusinessError) => { 471 console.error(`getMissionInfos fail, error: ${error}`); 472 }); 473 474 missionManager.lockMission(id).catch((error: BusinessError) => { 475 console.error(`lockMission fail, error: ${error}`); 476 }); 477 ``` 478 479 480## missionManager.unlockMission 481 482unlockMission(missionId: number, callback: AsyncCallback<void>): void; 483 484Unlocks a given mission. This API uses an asynchronous callback to return the result. 485 486**Required permissions**: ohos.permission.MANAGE_MISSIONS 487 488**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 489 490**System API**: This is a system API and cannot be called by third-party applications. 491 492**Parameters** 493 494| Name| Type| Mandatory| Description| 495| -------- | -------- | -------- | -------- | 496| missionId | number | Yes| Mission ID.| 497| callback | AsyncCallback<void> | Yes| Callback used to return the result.| 498 499**Example** 500 501 ```ts 502 import missionManager from '@ohos.application.missionManager'; 503 504 missionManager.getMissionInfos('', 10, (error, missions) => { 505 if (error.code) { 506 console.error(`getMissionInfos failed, error.code: ${error.code}, error.message: ${error.message}`); 507 return; 508 } 509 console.log(`size = ${missions.length}`); 510 console.log(`missions = ${JSON.stringify(missions)}`); 511 let id = missions[0].missionId; 512 513 missionManager.unlockMission(id).then(() => { 514 console.log('unlockMission is called '); 515 }); 516 }); 517 ``` 518 519 520## missionManager.unlockMission 521 522unlockMission(missionId: number): Promise<void>; 523 524Unlocks a given mission. This API uses a promise to return the result. 525 526**Required permissions**: ohos.permission.MANAGE_MISSIONS 527 528**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 529 530**System API**: This is a system API and cannot be called by third-party applications. 531 532**Parameters** 533 534 | Name| Type| Mandatory| Description| 535 | -------- | -------- | -------- | -------- | 536 | missionId | number | Yes| Mission ID.| 537 538**Return value** 539 540 | Type| Description| 541 | -------- | -------- | 542 | Promise<void> | Promise used to return the result.| 543 544**Example** 545 546 ```ts 547 import missionManager from '@ohos.application.missionManager'; 548 import { BusinessError } from '@ohos.base'; 549 550 let id: number = -1; 551 missionManager.getMissionInfos('',10).then((res) => { 552 let allMissions = res; 553 console.log(`size = ${allMissions.length}`); 554 console.log(`missions = ${JSON.stringify(allMissions)}`); 555 id = allMissions[0].missionId; 556 }).catch((error: BusinessError) => { 557 console.error(`getMissionInfos fail, error: ${error}`); 558 }); 559 560 missionManager.lockMission(id).catch((error: BusinessError) => { 561 console.error(`lockMission fail, error: ${error}`); 562 }); 563 missionManager.unlockMission(id).catch((error: BusinessError) => { 564 console.error(`unlockMission fail, error: ${error}`); 565 }); 566 ``` 567 568 569## missionManager.clearMission 570 571clearMission(missionId: number, callback: AsyncCallback<void>): void; 572 573Clears a given mission, regardless of whether it is locked. This API uses an asynchronous callback 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 | callback | AsyncCallback<void> | Yes| Callback used to return the result.| 587 588**Example** 589 590 ```ts 591 import missionManager from '@ohos.application.missionManager'; 592 593 missionManager.getMissionInfos('', 10, (error, missions) => { 594 if (error.code) { 595 console.error(`getMissionInfos failed, error.code: ${error.code}, error.message: ${error.message}`); 596 return; 597 } 598 console.log(`size = ${missions.length}`); 599 console.log(`missions = ${JSON.stringify(missions)}`); 600 let id = missions[0].missionId; 601 602 missionManager.clearMission(id).then(() => { 603 console.log('clearMission is called '); 604 }); 605 }); 606 ``` 607 608 609## missionManager.clearMission 610 611clearMission(missionId: number): Promise<void>; 612 613Clears a given mission, regardless of whether it is locked. This API uses a promise to return the result. 614 615**Required permissions**: ohos.permission.MANAGE_MISSIONS 616 617**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 618 619**System API**: This is a system API and cannot be called by third-party applications. 620 621**Parameters** 622 623 | Name| Type| Mandatory| Description| 624 | -------- | -------- | -------- | -------- | 625 | missionId | number | Yes| Mission ID.| 626 627**Return value** 628 629 | Type| Description| 630 | -------- | -------- | 631 | Promise<void> | Promise used to return the result.| 632 633**Example** 634 635 ```ts 636 import missionManager from '@ohos.application.missionManager'; 637 import { BusinessError } from '@ohos.base'; 638 639 let id: number = -1; 640 missionManager.getMissionInfos('',10).then((res) => { 641 let allMissions = res; 642 console.log(`size = ${allMissions.length}`); 643 console.log(`missions = ${JSON.stringify(allMissions)}`); 644 id = allMissions[0].missionId; 645 }).catch((error: BusinessError) => { 646 console.error(`getMissionInfos fail, error: ${error}`); 647 }); 648 649 missionManager.clearMission(id).catch((error: BusinessError) => { 650 console.error(`clearMission fail, error: ${error}`); 651 }); 652 ``` 653 654 655## missionManager.clearAllMissions 656 657clearAllMissions(callback: AsyncCallback<void>): void; 658 659Clears all unlocked missions. This API uses an asynchronous callback to return the result. 660 661**Required permissions**: ohos.permission.MANAGE_MISSIONS 662 663**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 664 665**System API**: This is a system API and cannot be called by third-party applications. 666 667**Example** 668 669 ```ts 670 import missionManager from '@ohos.application.missionManager' 671 672 missionManager.clearAllMissions().then(() => { 673 console.log('clearAllMissions is called '); 674 }); 675 ``` 676 677 678## missionManager.clearAllMissions 679 680clearAllMissions(): Promise<void>; 681 682Clears all unlocked missions. This API uses a promise to return the result. 683 684**Required permissions**: ohos.permission.MANAGE_MISSIONS 685 686**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 687 688**System API**: This is a system API and cannot be called by third-party applications. 689 690**Return value** 691 692 | Type| Description| 693 | -------- | -------- | 694 | Promise<void> | Promise used to return the result.| 695 696**Example** 697 698 ```ts 699 import missionManager from '@ohos.application.missionManager'; 700 import { BusinessError } from '@ohos.base'; 701 702 missionManager.clearAllMissions().catch((error: BusinessError) => { 703 console.error('clearAllMissions fail, error: ${error}'); 704 }); 705 ``` 706 707 708## missionManager.moveMissionToFront 709 710moveMissionToFront(missionId: number, callback: AsyncCallback<void>): void; 711 712Switches a given mission to the foreground. This API uses an asynchronous callback to return the result. 713 714**Required permissions**: ohos.permission.MANAGE_MISSIONS 715 716**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 717 718**System API**: This is a system API and cannot be called by third-party applications. 719 720**Parameters** 721 722 | Name| Type| Mandatory| Description| 723 | -------- | -------- | -------- | -------- | 724 | missionId | number | Yes| Mission ID.| 725 | callback | AsyncCallback<void> | Yes| Callback used to return the result.| 726 727**Example** 728 729 ```ts 730 import missionManager from '@ohos.application.missionManager'; 731 732 missionManager.getMissionInfos('', 10, (error, missions) => { 733 if (error.code) { 734 console.error(`getMissionInfos failed, error.code: ${error.code}, error.message: ${error.message}`); 735 return; 736 } 737 console.log(`size = ${missions.length}`); 738 console.log(`missions = ${JSON.stringify(missions)}`); 739 let id = missions[0].missionId; 740 741 missionManager.moveMissionToFront(id).then(() => { 742 console.log('moveMissionToFront is called '); 743 }); 744 }); 745 ``` 746 747 748## missionManager.moveMissionToFront 749 750moveMissionToFront(missionId: number, options: StartOptions, callback: AsyncCallback<void>): void; 751 752Switches a given mission to the foreground, with the startup parameters for the switching specified. This API uses an asynchronous callback to return the result. 753 754**Required permissions**: ohos.permission.MANAGE_MISSIONS 755 756**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 757 758**System API**: This is a system API and cannot be called by third-party applications. 759 760**Parameters** 761 762 | Name| Type| Mandatory| Description| 763 | -------- | -------- | -------- | -------- | 764 | missionId | number | Yes| Mission ID.| 765 | 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.| 766 | callback | AsyncCallback<void> | Yes| Callback used to return the result.| 767 768**Example** 769 770 ```ts 771 import missionManager from '@ohos.application.missionManager'; 772 773 missionManager.getMissionInfos('', 10, (error, missions) => { 774 if (error.code) { 775 console.error(`getMissionInfos failed, error.code: ${error.code}, error.message: ${error.message}`); 776 return; 777 } 778 console.log(`size = ${missions.length}`); 779 console.log(`missions = ${JSON.stringify(missions)}`); 780 let id = missions[0].missionId; 781 782 missionManager.moveMissionToFront(id,{windowMode : 101}).then(() => { 783 console.log('moveMissionToFront is called '); 784 }); 785 }); 786 ``` 787 788 789## missionManager.moveMissionToFront 790 791moveMissionToFront(missionId: number, options?: StartOptions): Promise<void>; 792 793Switches a given mission to the foreground, with the startup parameters for the switching specified. This API uses a promise to return the result. 794 795**Required permissions**: ohos.permission.MANAGE_MISSIONS 796 797**System capability**: SystemCapability.Ability.AbilityRuntime.Mission 798 799**System API**: This is a system API and cannot be called by third-party applications. 800 801**Parameters** 802 803 | Name| Type| Mandatory| Description| 804 | -------- | -------- | -------- | -------- | 805 | missionId | number | Yes| Mission ID.| 806 | 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.| 807 808**Return value** 809 810 | Type| Description| 811 | -------- | -------- | 812 | Promise<void> | Promise used to return the result.| 813 814**Example** 815 816 ```ts 817 import missionManager from '@ohos.application.missionManager'; 818 import { BusinessError } from '@ohos.base'; 819 820 let id: number = -1; 821 missionManager.getMissionInfos('',10).then((res) => { 822 let allMissions = res; 823 console.log(`size = ${allMissions.length}`); 824 console.log(`missions = ${JSON.stringify(allMissions)}`); 825 id = allMissions[0].missionId; 826 }).catch((error: BusinessError) => { 827 console.error(`getMissionInfos fail, error: ${error}`); 828 }); 829 830 missionManager.moveMissionToFront(id).catch((error: BusinessError) => { 831 console.error(`moveMissionToFront fail, error: ${error}`); 832 }); 833 ``` 834