Skip to main content

Test Set Pre-requisites

Written by Ines

A pre-requisite lets you designate one test case in a Test Set that must pass before the rest of the set runs.

What is a Pre-requisite Test?

Inside a Test Set, you can promote one of your test cases to be the pre-requisite. It runs first, on its own, before everything else. The remaining cases — the main tests — only start if the pre-requisite succeeds. This is useful for setup the other tests depend on, such as seeding data or resetting the environment.

  • One pre-requisite per Test Set (at most).

  • A test case can't be both the pre-requisite and a main test in the same set.

  • It's optional — a set with no pre-requisite runs all of its test cases together.

How to Add a Pre-requisite

  1. Open the Test Set and go to the Test Cases tab. The list is split into two sections: Pre-requisite Test and Main Tests.

  2. In the Pre-requisite Test section, click Add pre-requisite.

  3. In the Manage Pre-requisite dialog, search for and select the test case that must pass first.

  4. Click Apply changes.

How a Test Set Runs with a Pre-requisite

When you run the set, the pre-requisite and the main tests are queued together, but each main test waits for the pre-requisite before it actually executes:

  • If the pre-requisite succeeds, the main tests run as usual.

  • If it fails, is canceled, or is stopped, the main tests are Canceled.

  • If retries are enabled, the main tests start as soon as the pre-requisite succeeds on any attempt; if it uses up all its retries and still fails, they're canceled.

  • With a data file, each row is handled independently — a row's main tests start when that row's pre-requisite succeeds, and only that row's main tests are canceled if it fails.

  • Parallelism: once the pre-requisite passes, the main tests run under the Test Set's Max Parallelism setting, just as they would without a pre-requisite.

In your test runs, the pre-requisite appears in the run list alongside the set's main tests, marked with the same Pre-requisite badge.

Did this answer your question?