• Public
  • Public/Protected
  • All

Entry point to discover and execute tests. It contains TestController.items which are used to populate the editor UI, and is associated with run profiles to allow for tests to be executed.


  • TestController



Readonly id

id: string

The id of the controller passed in vscode.tests.createTestController. This must be globally unique.


label: string

Human-readable label for the test controller.

Readonly items

A collection of "top-level" TestItem instances, which can in turn have their own children to form the "test tree."

The extension controls when to add tests. For example, extensions should add tests for a file when vscode.workspace.onDidOpenTextDocument fires in order for decorations for tests within a file to be visible.

However, the editor may sometimes explicitly request children using the resolveHandler See the documentation on that method for more details.



Optional resolveHandler

  • A function provided by the extension that the editor may call to request children of a test item, if the TestItem.canResolveChildren is true. When called, the item should discover children and call {@link vscode.tests.createTestItem} as children are discovered.

    Generally the extension manages the lifecycle of test items, but under certain conditions the editor may request the children of a specific item to be loaded. For example, if the user requests to re-run tests after reloading the editor, the editor may need to call this method to resolve the previously-run tests.

    The item in the explorer will automatically be marked as "busy" until the function returns or the returned thenable resolves.


    • item: undefined | TestItem

      An unresolved test item for which children are being requested, or undefined to resolve the controller's initial items.

    Returns void | Thenable<void>


  • Creates a TestRun. This should be called by the TestRunProfile when a request is made to execute tests, and may also be called if a test run is detected externally. Once created, tests that are included in the request will be moved into the queued state.

    All runs created using the same request instance will be grouped together. This is useful if, for example, a single suite of tests is run on multiple platforms.


    • request: TestRunRequest

      Test run request. Only tests inside the include may be modified, and tests in its exclude are ignored.

    • Optional name: 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.

    • Optional persist: boolean

      Whether the results created by the run should be persisted in the editor. This may be false if the results are coming from a file already saved externally, such as a coverage information file.

    Returns TestRun

    An instance of the TestRun. It will be considered "running" from the moment this method is invoked until TestRun.end is called.


  • createTestItem(id: string, label: string, uri?: Uri): TestItem


  • dispose(): void
  • Unregisters the test controller, disposing of its associated tests and unpersisted results.

    Returns void

友链:VS Code 中文文档 | VS Code 官网文档 | VS Code 扩展市场

Generated by TypeDoc. Maintained by 洛竹