A TestRun represents an in-progress or completed test run and provides methods to report the state of individual tests in the run.

interface TestRun {
    isPersisted: boolean;
    name: undefined | string;
    onDidDispose: Event<void>;
    token: CancellationToken;
    addCoverage(fileCoverage): void;
    appendOutput(output, location?, test?): void;
    end(): void;
    enqueued(test): void;
    errored(test, message, duration?): void;
    failed(test, message, duration?): void;
    passed(test, duration?): void;
    skipped(test): void;
    started(test): void;
}

Implemented by

Properties

isPersisted: boolean

Whether the test run will be persisted across reloads by the editor.

name: undefined | string

The human-readable name of the run. This can be used to disambiguate multiple sets of results in a test run. It is useful if tests are run across multiple platforms, for example.

onDidDispose: Event<void>

An event fired when the editor is no longer interested in data associated with the test run.

A cancellation token which will be triggered when the test run is canceled from the UI.

Methods

  • Appends raw output from the test runner. On the user's request, the output will be displayed in a terminal. ANSI escape sequences, such as colors and text styles, are supported. New lines must be given as CRLF (\r\n) rather than LF (\n).

    Parameters

    • output: string

      Output text to append.

    • Optional location: Location

      Indicate that the output was logged at the given location.

    • Optional test: TestItem

      Test item to associate the output with.

    Returns void

  • Signals the end of the test run. Any tests included in the run whose states have not been updated will have their state reset.

    Returns void

  • Indicates a test has errored. You should pass one or more TestMessages to describe the failure. This differs from the "failed" state in that it indicates a test that couldn't be executed at all, from a compilation error for example.

    Parameters

    • test: TestItem

      Test item to update.

    • message: TestMessage | readonly TestMessage[]

      Messages associated with the test failure.

    • Optional duration: number

      How long the test took to execute, in milliseconds.

    Returns void

  • Indicates a test has failed. You should pass one or more TestMessages to describe the failure.

    Parameters

    • test: TestItem

      Test item to update.

    • message: TestMessage | readonly TestMessage[]

      Messages associated with the test failure.

    • Optional duration: number

      How long the test took to execute, in milliseconds.

    Returns void

  • Indicates a test has passed.

    Parameters

    • test: TestItem

      Test item to update.

    • Optional duration: number

      How long the test took to execute, in milliseconds.

    Returns void