Viewing and Analyzing Results: Anatomy of the Results Viewer
The Results Viewer is a large window with several panels (see Figure 11-1).
Before you use the Viewer for the first time, take some time to familiarize yourself with each of the buttons and panels. This section describes each of the components.

Results Viewer
Task Buttons
The Viewer task buttons are the five buttons in the far left panel, excluding the View Options selections. These represent the main functions provided by the Results Viewer.
Task Buttons
Button
|
Use this to
|
Open...
|
Open a .log file or the log from archived results, for viewing.
|
Extract Results...
|
Extract the results you want from the log and write them to an HTML or text file.
|
Archive Results...
|
Archive all results from a test run, including gold files and failure files, into a .zip file.
|
Print...
|
Print the current results screen.
|
Close...
|
Close the Results Viewer
|
View Options
These options, located in the middle of the far left panel, control the nodes you see in the Test Results panel. Only one option can be set at a time.
Note - If you are viewing results from a single-script test run, you probably don't need to use View Options, as your test consists of a single node.
View Options
Option
|
Sets test results to display
|
All
|
All of the nodes in the JST. This setting is the default.
|
Failures
|
Only the nodes that contain failures.
|
Exceptions
|
Only the nodes that ended by throwing exceptions.
|
Restarts
|
Only the nodes set to restart the application or applet. By its nature, the root node is always considered a restart node.
|
Test Results
This is the panel showing each node of your JST in tree format. If you ran a single script, you'll see only one node.
Any node with a plus sign (+) proceeding it can be expanded to reveal child nodes. You can expand a node just by clicking on the plus sign--the plus converts to a minus (-) and all the child nodes appear below the JST. You can also collapse an expanded node by clicking on the minus sign.
If a node contained a failure, the text failures:
followed by the number of failures appears below the node. This gives you an idea of which results you might want to explore in more detail.
Summary
This panel offers a summary of results for the node you have currently selected. If you select the a JST node (such as the first node), the Summary panel includes data from the child nodes.
The Summary panel reports on:
- The number of JST nodes that ended normally. A node that contains verification or
JS.check
failures, but which does not throw an exception, is considered normal.
- The number of JST nodes that ended by throwing an exception.
- A count of the verifications that passed.
- A count of all verification failures.
- A count of any verification errors that occurred. Verification errors are not failures, because they indicate that the verification couldn't be performed--such as: can't find gold file for comparison.
- The number of
JS.check
method calls that passed. (JS.check
is a method in the JavaStar API that you can use to manually insert your own comparison code into a script.)
- The number of
JS.check
method calls that failed.
- The duration of the test run.
Details
The Details panel, located to the middle and lower right of the window, provides:
- A panel showing the log results pertaining to the currently selected node. This display reflects the options you set in View Options and with the buttons below this panel.
- Three buttons for navigating to failures--these are only enabled when the node you selected contains a failure. (See Table 11-3).
Failure navigation buttons
Button
|
Action
|
Previous Failure
|
Moves back to the previous failure.
|
Next Failure
|
Jumps to the first failure or to a failure subsequent to the current one.
|
View Failure
|
Opens up the Gold File Manager, as well as the gold file and the comparing image that failured. The Gold File manager is covered in detail in Viewing Comparison Failures and Updating Gold Files.
|
- A series of check boxes that you can toggle on and off, affecting the types of information displayed and the format (See Table 11-4).
Type and format check boxes
Check box
|
When toggled on
|
Times
|
Includes timestamps.
|
Events
|
Includes each event call made within the script
|
StdOut
|
Includes any messages sent to StdOut.
|
StdErr
|
Includes any messages sent to StdErr.
|
Process Info
|
Includes the system information from the test machine, playback options in effect, the start and end time of the test, and any
|
Shortened lines
|
Sets each line to use a terse format. Each line that has been shortened is prefaced by a plus sign in a circle. You can click on this to expand the line for more details about the event.
|
- ReLoad button--this is the button you need to click each time you change the settings for type or format. Reload opens the log file again, filtering for the information you want.
Send feedback to
JavaStar-feedback@suntest.com
Copyright © 1998
Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, CA 94303.
All rights reserved.