1# Want Overview
2
3
4## Definition and Usage of Want
5
6[Want](../reference/apis-ability-kit/js-apis-app-ability-want.md) is an object that transfers information between application components. It is often used as a parameter of [startAbility()](../reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextstartability). For example, when UIAbilityA needs to start UIAbilityB and transfer some data to UIAbilityB, it can use the **want** parameter in **startAbility()** to transfer the data.
7
8**Figure 1** Want usage
9
10![usage-of-want](figures/usage-of-want.png)
11
12
13## Types of Want
14
15- **Explicit Want**: If **abilityName** and **bundleName** are specified in the [want](../reference/apis-ability-kit/js-apis-app-ability-want.md) parameter when starting an application component, explicit Want is used.
16
17    Explicit Want is usually used to start another application component in the same application. You can use the bundle name and ability name in the **Want** object to specify the target component. When there is an explicit object to process the request, explicit Want is a simple and effective way to start the target application component.
18    > **NOTE**
19    >
20    > Since API version 12, it is not recommended that third-party applications start other applications by specifying an ability (implicit Want mode). Instead, the [linking mode](app-startup-overview.md#application-links) is recommended.
21
22  ```ts
23  import { Want } from '@kit.AbilityKit';
24
25  let wantInfo: Want = {
26    deviceId: '', // An empty deviceId indicates the local device.
27    bundleName: 'com.example.myapplication',
28    abilityName: 'FuncAbility',
29  }
30  ```
31
32- **Implicit Want**: If **abilityName** is not specified in the [want](../reference/apis-ability-kit/js-apis-app-ability-want.md) parameter when starting an application component, implicit Want is used.
33
34  Implicit Want can be used when the object used to process the request is unclear and the current application wants to use a capability (defined by the [skills tag](../quick-start/module-configuration-file.md#skills)) provided by another application. The system matches all applications that declare to support the capability. For example, for a link open request, the system matches all applications that support the request and provides the available ones for users to select.
35
36
37  ```ts
38  import { Want } from '@kit.AbilityKit';
39
40  let wantInfo: Want = {
41    // Uncomment the line below if you want to implicitly query data only in the specific bundle.
42    // bundleName: 'com.example.myapplication',
43    action: 'ohos.want.action.search',
44    // entities can be omitted.
45    entities: [ 'entity.system.browsable' ],
46    uri: 'https://www.test.com:8080/query/student',
47    type: 'text/plain',
48  };
49  ```
50
51  > **NOTE**
52  > - Depending on the application component matching result, the following cases may be possible when you attempt to use implicit Want to start the application component.
53  >   - No application component is matched. The startup fails.
54  >   - An application component that meets the conditions is matched. That application component is started.
55  >   - Multiple [UIAbility](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md) components that meet the conditions are matched. A dialog box is displayed for users to select one of them.
56  >
57  > - In the scenario for starting the ServiceExtensionAbility component:
58  >   - If the [want](../reference/apis-ability-kit/js-apis-app-ability-want.md) parameter passed in contains **abilityName**, the ServiceExtensionAbility component cannot be started through implicit Want.
59  >   - If the **want** parameter passed in contains **bundleName**, the **startServiceExtensionAbility()** method can be used to implicitly start the ServiceExtensionAbility component. By default, the ServiceExtensionAbility component with the highest priority is returned. If all the matching ServiceExtensionAbility components have the same priority, the first ServiceExtensionAbility component is returned.
60