TestRunRequest

A TestRunRequest is a precursor to a TestRun, which in turn is created by passing a request to TestController.createTestRun. The TestRunRequest contains information about which tests should be run, which should not be run, and how they are run (via the profile).

In general, TestRunRequests are created by the editor and pass to TestRunProfile.runHandler, however you can also create test requests and runs outside of the runHandler.

Online Documentation

Constructors

Link copied to clipboard
constructor(include: ReadonlyArray<TestItem> = definedExternally, exclude: ReadonlyArray<TestItem> = definedExternally, profile: TestRunProfile = definedExternally, continuous: Boolean = definedExternally, preserveFocus: Boolean = definedExternally)

Properties

Link copied to clipboard

Whether the profile should run continuously as source code changes. Only relevant for profiles that set TestRunProfile.supportsContinuousRun.

Link copied to clipboard

An array of tests the user has marked as excluded from the test included in this run; exclusions should apply after inclusions.

Link copied to clipboard

A filter for specific tests to run. If given, the extension should run all of the included tests and all their children, excluding any tests that appear in TestRunRequest.exclude. If this property is undefined, then the extension should simply run all tests.

Link copied to clipboard

Controls how test Test Results view is focused. If true, the editor will keep the maintain the user's focus. If false, the editor will prefer to move focus into the Test Results view, although this may be configured by users.

Link copied to clipboard

The profile used for this request. This will always be defined for requests issued from the editor UI, though extensions may programmatically create requests not associated with any profile.