Re-run failed tests within a test suite without rerunning the entire suite.

Before you begin

Role required: atf_test_admin, atf_test_designer, or admin

About this task

The Re-run failed tests button appears on the Suite Result form and on the Suite Execution Progress Viewer after a suite with failed tests completes. It does not appear if test execution is disabled, the suite is deactivated, the suite passed, or the user does not have one of the required roles.

The Re-run failed tests button re-runs all non-passing tests, which includes tests with the following status: canceled, skipped, failure, and error. It does not include the test results with a Success with warning(s) status.

Procedure

  1. Navigate to either the suite result form or suite execution progress viewer for the completed suite that had failed tests.
  2. Click Re-run failed tests.
    If the re-run tests include a form step (any step involving a UI) or other kinds of UI test steps, the Pick a Browser dialog appears before executing the tests.
  3. In the dialog box, choose among any currently running test clients or start a new runner.
    If the re-run tests include only server test steps, the system executes the tests without displaying the Pick a Browser dialog. For more information, review Browser recommendations for all tests and suites and Server test steps.

Result

The system re-runs the failed tests.
  • The system creates a new suite result hierarchy for the re-run tests. The Progress Workers, Test Result, and Test Suite Result forms show the same suite hierarchy as the previous test suite. They do not include the tests or suites that passed in a previous run.
  • If you delete or deactivate a child suite or test that failed, and then re-run it, the system does not execute that suite or test in the re-run.
  • If you add a child suite or test to the suite to a failed test, and then re-run it, the system does not execute the added suite or test in the re-run.

What to do next

To view the results from the previous run of a test or suite, click Previous test result on the test result form or Previous suite result on the testsuite result form. These fields only appear for tests and suites that have been re-run.