The test tree provides a pop-up menu. Displaying the pop-up menu for a folder or test is a platform specific operation (such as right clicking the folder or test icon in the test tree). You can also press Shift-F10 to display the pop-up menu for the test with focus.
The pop-up menu contains the following menu items:
The JavaTest harness does not allow you to perform operations using the pop-up menu when it is running tests. The JavaTest harness displays an error dialog box if you attempt to perform an operation using the pop-up menu when tests are running.
See Keyboard Access for a description of how you can use the keyboard to open and navigate the pop-up menu.
You can use the Execute these tests menu item to run the tests and folders highlighted in the test tree.
The JavaTest harness does not automatically perform a refresh operation before running the tests. If changes are made to a test suite, you must perform a refresh before running tests. See Refresh Test Suite Contents for a description of the refresh operation.
To perform a quick pick test execution of specific folders or tests, complete the following actions:
You must left click to select nodes. When more than one folder or test is highlighted in the test tree, the Test Manager displays a list of the selected tests and folders in the information area.
Selecting a test executes only that test.
Selecting a folder executes all tests currently known to the test manager in and below that folder.
Opening the pop-up menu is a platform-specific operation (such as right clicking in the test tree pane).
In place of the Tests setting in the current configuration, the JavaTest harness uses the quick pick tree selection with the remaining values from the configuration to run the tests.
If the test manager does not contain a completed configuration, the JavaTest harness displays an advisory message and does not start the test run.
If the test manager contains a completed configuration, the JavaTest harness displays an advisory message to confirm the execute operation.
As it does during a routine test run, the JavaTest harness updates all icons and progress monitors during test execution.
When developing tests, changes in a test suite are not automatically detected by the JavaTest harness. The first time tests are run, the JavaTest harness uses the test finder to read test descriptions. If the harness loads tests from an existing work directory, the test descriptions contained in those results are used by default.
The refresh operation enables test developers to load changes they might have made in a test suite without restarting the JavaTest harness or reloading the test suite.
The JavaTest harness does not require a work directory to perform a refresh of the test suite.
If you are viewing the test panel after refreshing a test or folder, update the test tree by choosing a different test or folder icon and repeating your test tree choice.
To refresh the contents of tests and folders, complete the following actions:
You must left click to select a node. When more than one folder or test is highlighted in the test tree, the Test Manager displays a list of the selected tests and folders in the information area.
Selecting a test chooses only that test.
Selecting a folder chooses all tests currently known to the test manager in and below that folder.
Opening the pop-up menu is a platform-specific operation (such as right clicking in the test tree pane).
You can use the Clear Results menu item to remove existing test results for any combination of tests and folders.
To clear test results, you must have an open work directory.
To clear a test result, complete the following actions:
You must left click to select a node. When more than one test is highlighted in the test tree, the Test Manager displays a list of the selected tests and folders in the information area.
Opening the pop-up menu is a platform-specific operation (such as right clicking in the test tree pane).
The JavaTest harness performs the following actions:
- Removes the .jtr file from the work directory for that test.
- Refreshes the test description for that test.
- Displays the test in the Not Run state.
To clear the test results in a folder, complete the following actions:
You must left click to select a node. When more than one folder is highlighted in the test tree, the Test Manager displays a list of the selected tests and folders in the information area.
Opening the pop-up menu is a platform-specific operation (such as right clicking in the test tree pane).
The JavaTest harness performs the following actions:
- Removes all .jtr files from the work directory for all tests in and below that folder.
- Deletes all other files in and below the folder in the work directory.
- Deletes all other directories corresponding to the folders in and below the folder in the work directory.
- Displays the folder and its tests as Not Run.
The JavaTest harness does not display an error message if it is unable to delete a folder or file from the work directory.