1# Want概述
2
3
4## Want的定义与用途
5
6[Want](../reference/apis-ability-kit/js-apis-app-ability-want.md)是一种对象，用于在应用组件之间传递信息。
7
8其中，一种常见的使用场景是作为[startAbility()](../reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextstartability)方法的参数。例如，当UIAbilityA需要启动UIAbilityB并向UIAbilityB传递一些数据时，可以使用Want作为一个载体，将数据传递给UIAbilityB。
9
10**图1** Want用法示意
11![usage-of-want](figures/usage-of-want.png)
12
13
14## Want的类型
15
16- **显式Want**：在启动目标应用组件时，调用方传入的[want](../reference/apis-ability-kit/js-apis-app-ability-want.md)参数中指定了abilityName和bundleName，称为显式Want。
17
18    显式Want通常用于应用内组件启动，通过在Want对象内指定本应用Bundle名称信息（bundleName）和abilityName来启动应用内目标组件。当有明确处理请求的对象时，显式Want是一种简单有效的启动目标应用组件的方式。
19    > **说明：**
20    >
21    > 从API 12开始，已不再推荐三方应用使用指定Ability方式（即显式Want）拉起其他应用，推荐通过指定[应用链接](app-startup-overview.md#应用链接)的方式来实现。
22
23  ```ts
24  import { Want } from '@kit.AbilityKit';
25
26  let wantInfo: Want = {
27    deviceId: '', // deviceId为空表示本设备
28    bundleName: 'com.example.myapplication',
29    abilityName: 'FuncAbility',
30  }
31  ```
32
33- **隐式Want**：在启动目标应用组件时，调用方传入的[want](../reference/apis-ability-kit/js-apis-app-ability-want.md)参数中未指定abilityName，称为隐式Want。
34
35  当需要处理的对象不明确时，可以使用隐式Want，在当前应用中使用其他应用提供的某个能力，而不关心提供该能力的具体应用。隐式Want使用[skills标签](../quick-start/module-configuration-file.md#skills标签)来定义需要使用的能力，并由系统匹配声明支持该请求的所有应用来处理请求。例如，需要打开一个链接的请求，系统将匹配所有声明支持该请求的应用，然后让用户选择使用哪个应用打开链接。
36
37
38  ```ts
39  import { Want } from '@kit.AbilityKit';
40
41  let wantInfo: Want = {
42    // uncomment line below if wish to implicitly query only in the specific bundle.
43    // bundleName: 'com.example.myapplication',
44    action: 'ohos.want.action.search',
45    // entities can be omitted
46    entities: [ 'entity.system.browsable' ],
47    uri: 'https://www.test.com:8080/query/student',
48    type: 'text/plain',
49  };
50  ```
51
52  > **说明：**
53  > - 根据系统中待匹配应用组件的匹配情况不同，使用隐式Want启动应用组件时会出现以下三种情况。
54  >   - 未匹配到满足条件的应用组件：启动失败。
55  >   - 匹配到一个满足条件的应用组件：直接启动该应用组件。
56  >   - 匹配到多个满足条件的应用组件（[UIAbility](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md)）：弹出选择框让用户选择。
57  >
58  > - 对于启动ServiceExtensionAbility的场景。
59  >   - 调用方传入的[want](../reference/apis-ability-kit/js-apis-app-ability-want.md)参数中带有abilityName，则不允许通过隐式Want启动ServiceExtensionAbility。
60  >   - 调用方传入的want参数中带有bundleName，则允许使用startServiceExtensionAbility()方法隐式Want启动ServiceExtensionAbility，默认返回优先级最高的ServiceExtensionAbility，如果优先级相同，返回第一个。
61