A TestRunRequest is a precursor to a {@link TestRun}, which in turn is created by passing a request to {@link TestController.createTestRun}. The TestRunRequest contains information about which tests should be run, which should not be run, and how they are run (via the {@link TestRunRequest.profile profile}).
In general, TestRunRequests are created by the editor and pass to
{@link TestRunProfile.runHandler}, however you can also create test
requests and runs outside of the runHandler.
Constructor
new(?include:ReadOnlyArray<TestItem>, ?exclude:ReadOnlyArray<TestItem>, ?profile:Null<TestRunProfile>)
Parameters:
include | Array of specific tests to run, or undefined to run all tests |
|---|---|
exclude | An array of tests to exclude from the run. |
profile | The run profile used for this request. |
continuous | Whether to run tests continuously as source changes. |
preserveFocus | Whether to preserve the user's focus when the run is started |
Variables
read onlycontinuous:Null<Bool>
Whether the profile should run continuously as source code changes. Only relevant for profiles that set {@link TestRunProfile.supportsContinuousRun}.
read onlyexclude:Null<ReadOnlyArray<TestItem>>
An array of tests the user has marked as excluded from the test included in this run; exclusions should apply after inclusions.
May be omitted if no exclusions were requested. Test controllers should not run excluded tests or any children of excluded tests.
read onlyinclude:Null<ReadOnlyArray<TestItem>>
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 {@link TestRunRequest.exclude}. If this property is undefined, then the extension should simply run all tests.
The process of running tests should resolve the children of any test items who have not yet been resolved.
read onlypreserveFocus:Bool
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.
read onlyprofile:Null<TestRunProfile>
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.