@ohos.application.testRunner (TestRunner)

The TestRunner module provides a test framework. You can use the APIs of this module to prepare the unit test environment and run test cases.

To implement your own unit test framework, extend this class and override its APIs.

NOTE

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

The APIs of this module can be used only in JsUnit.

Modules to Import

import { TestRunner } from '@kit.TestKit';

TestRunner.onPrepare

onPrepare(): void

Prepares the unit test environment to run test cases.

System capability: SystemCapability.Ability.AbilityRuntime.Core

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

Example

import { TestRunner } from '@kit.TestKit';

export default class UserTestRunner implements TestRunner {
  onPrepare() {
    console.info('Trigger onPrepare');
  }

  onRun() {
  }
}

TestRunner.onRun

onRun(): void

Runs test cases.

System capability: SystemCapability.Ability.AbilityRuntime.Core

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

Example

import { TestRunner } from '@kit.TestKit';

export default class UserTestRunner implements TestRunner {
  onPrepare() {
  }

  onRun() {
    console.info('Trigger onRun');
  }
}

TestRunner.onStop

onStop(): void

Called when the test is complete and before the test environment exits.

Since: 26.0.0

System capability: SystemCapability.Ability.AbilityRuntime.Core

Model restriction: This API can be used only in the stage model.

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

Example

import { TestRunner } from '@kit.TestKit';

export default class UserTestRunner implements TestRunner {
  onPrepare() {
    console.info('Trigger onPrepare');
  }

  onRun() {
    console.info('Trigger onRun');
  }

  onStop() {
    console.info('Trigger onStop');
  }
}