@ohos.app.ability.wantConstant (wantConstant)

The wantConstant module provides the actions, entities, and flags used in Want objects.

NOTE

The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.

Modules to Import

import wantConstant from '@ohos.app.ability.wantConstant';

wantConstant.Params

Defines Params (specifying the action that can be performed) in the Want.

Atomic service API: This API can be used in atomic services since API version 11.

System capability: SystemCapability.Ability.AbilityBase

Name	Value	Description
ABILITY_BACK_TO_OTHER_MISSION_STACK	ability.params.backToOtherMissionStack	Action of redirection back across mission stacks.
ABILITY_RECOVERY_RESTART¹⁰⁺	ohos.ability.params.abilityRecoveryRestart	Action of recovering an ability from a fault and restarting it.
CONTENT_TITLE_KEY¹⁰⁺	ohos.extra.param.key.contentTitle	Action of sharing the content title.
SHARE_ABSTRACT_KEY¹⁰⁺	ohos.extra.param.key.shareAbstract	Action of sharing the abstract.
SHARE_URL_KEY¹⁰⁺	ohos.extra.param.key.shareUrl	Action of sharing the URL.
SUPPORT_CONTINUE_PAGE_STACK_KEY¹⁰⁺	ohos.extra.param.key.supportContinuePageStack	Action of migrating page stack information during cross-device migration. The default value is true, indicating that page stack information is automatically migrated.
SUPPORT_CONTINUE_SOURCE_EXIT_KEY¹⁰⁺	ohos.extra.param.key.supportContinueSourceExit	Action of exiting the application on the source device during cross-device migration. The default value is true, indicating that the application on the source device automatically exits.

wantConstant.Flags

Enumerates the flags that specify how the Want will be handled.

System capability: SystemCapability.Ability.AbilityBase

Name	Value	Description
FLAG_AUTH_READ_URI_PERMISSION	0x00000001	Grant the permission to read the URI. Atomic service API: This API can be used in atomic services since API version 11.
FLAG_AUTH_WRITE_URI_PERMISSION	0x00000002	Grant the permission to write data to the URI. Atomic service API: This API can be used in atomic services since API version 11.
FLAG_AUTH_PERSISTABLE_URI_PERMISSION¹²⁺	0x00000040	Make the URI persisted. It takes effect only on tablets.
FLAG_INSTALL_ON_DEMAND	0x00000800	Install the ability if it has not been installed. Atomic service API: This API can be used in atomic services since API version 11.
FLAG_START_WITHOUT_TIPS¹¹⁺	0x40000000	Do not display any tips if the ability implicitly started does not match any application.