This package contains the APIs that Test Adapters or Test Controllers need to implement to work with the VS Code Test Explorer.
The API documentation can be found here
Version 1.0 of this package contains a new Test Adapter API, which is very similar to the pre-1.0 API but requires some changes to Test Adapters. The old API is still supported but it is deprecated, so Test Adapters should move to the new API. You can still access the old API with an import like this:
import { TestAdapter } from 'vscode-test-adapter-api/out/legacy';
To move to the new API, the following changes are necessary:
- the Test Adapter must offer a new event source
teststhat is used to send events when it starts and finishes loading the test definitions:
tests: vscode.Event<TestLoadStartedEvent | TestLoadFinishedEvent>;
- when it detects any changes to the test files or its configuration that make it necessary to reload the test
definitions, it should start doing so immediately (instead of sending a
reloadevent and then waiting for a call toload()); thereloadevent source has been removed - the loaded test definitions are now sent using the
TestLoadFinishedEvent, not as the return value of theload()method - the
run()anddebug()methods now receive an array of test or suite IDs - it must send a
TestRunStartedEventand aTestRunFinishedEventat the beginning and end of a test run, repectively.