Identifier for the TestItem
. This is used to correlate
test results and tests in the document with those in the workspace
(test explorer). This cannot change for the lifetime of the TestItem
,
and must be unique among its parent's direct children.
URI this TestItem
is associated with. May be a file or directory.
The children of this test item. For a test suite, this may contain the individual test cases or nested suites.
The parent of this item. It's set automatically, and is undefined top-level items in the TestController.items and for items that aren't yet included in another item's children.
Tags associated with this test item. May be used in combination with tags, or simply as an organizational feature.
Indicates whether this test item may have children discovered by resolving.
If true, this item is shown as expandable in the Test Explorer view and expanding the item will cause TestController.resolveHandler to be invoked with the item.
Default to false
.
Controls whether the item is shown as "busy" in the Test Explorer view. This is useful for showing status while discovering children.
Defaults to false
.
Display name describing the test case.
Optional description that appears next to the label.
A string that should be used when comparing this item
with other items. When falsy
the label
is used.
Location of the test item in its uri.
This is only meaningful if the uri
points to a file.
Optional error encountered while loading the test.
Note that this is not a test result and should only be used to represent errors in test discovery, such as syntax errors.
An item shown in the "test explorer" view.
A
TestItem
can represent either a test suite or a test itself, since they both have similar capabilities.