Using the Test Tree

The test tree uses folder icons, test icons, and two independent, types of filtering (run filtering and view filtering) to simultaneously display:

• Progress of a test run
• Current test results in the work directory

When a test run begins, you can track its progress in the test tree by observing the folder and test icons. The test tree displays an arrow at the left of each folder and test icon as it is loaded and run.

After a test is completed, the JavaTest harness writes its results to the work directory and updates the folder and test icons in the test tree. The test tree displays folder and test icons based on the view filter specified in the Test Manager window.

The colors of the icons shown below are the JavaTest default settings. The JavaTest harness allows you to use colors other than these default settings. See Specifying Status Colors.

Regardless of whether or not the test was run, the test tree displays filtered out folder and test icons for those tests and folders filtered out by the view filter. All other icons are updated to reflect their current result status from the work directory.

Changing either the run or the view filter settings causes the JavaTest harness to immediately update the folder and test icons displayed in the test tree.

• See Using View Filters for a description of how to specify which test results from the work directory are displayed in the test tree.
• See Test Tree for a detailed description of the icons, filters, and other features used in the test tree.

The goal of a test run, when using the appropriate view filter, is for the root test suite folder to display the passed folder icon, signifying all tests in the test suite that are not filtered out of the test run by the current configuration (specifying tests that are run, exclude lists, keywords, and prior status) have passed. See Change Standard Values for a description of the run filters that can be used to include or remove tests from a test run.

Click the test suite icon in the test tree to display status information for the test suite in the Test Manager information area. The view filter used in the test tree is also used to display folder status information. See Folder View for a detailed description of the folder information displayed in this area.

By browsing the tabbed pane and the test tree, you can find the folders that contain tests that have not passed.