@ohos.application.abilityDelegatorRegistry (AbilityDelegatorRegistry)

The AbilityDelegatorRegistry module provides APIs for storing global registers of the registered AbilityDelegator and AbilityDelegatorArgs objects, including obtaining the AbilityDelegator and AbilityDelegatorArgs objects. The APIs can be used only in the test framework.

NOTE

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.abilityDelegatorRegistry instead. Newly added APIs will be marked with a superscript to indicate their earliest API version.

Modules to Import

import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry';

AbilityLifecycleState

Enumerates the ability lifecycle states.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Name	Value	Description
UNINITIALIZED	0	The ability is in an invalid state.
CREATE	1	The ability is created.
FOREGROUND	2	The ability is running in the foreground.
BACKGROUND	3	The ability is running in the background.
DESTROY	4	The ability is destroyed.

AbilityDelegatorRegistry.getAbilityDelegator

getAbilityDelegator(): AbilityDelegator

Obtains the AbilityDelegator object of the application.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Return value

Type	Description
AbilityDelegator	AbilityDelegator object, which can be used to schedule functions related to the test framework.

Example

import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry';

let abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();

AbilityDelegatorRegistry.getArguments

getArguments(): AbilityDelegatorArgs

Obtains the AbilityDelegatorArgs object of the application.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Return value

Type	Description
AbilityDelegatorArgs	AbilityDelegatorArgs object, which can be used to obtain test parameters.

Example

import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry';

let args = AbilityDelegatorRegistry.getArguments();
console.info(`getArguments bundleName: ${args.bundleName}`);
console.info(`getArguments testCaseNames: ${args.testCaseNames}`);
console.info(`getArguments testRunnerClassName: ${args.testRunnerClassName}`);