Test suite is a collection of test classes that you run quite often and for the same reason. For instance, this may be testing of some specific functionality. An ability to run test suites instead of separate test classes each time it's needed is a great helper and timesaver in your everyday development process.
Test Suite Manager
All the actions related to the test suites functionality are available through the Test Suite Manager. You can open it in three different ways:
- the Main Menu:
Test ⇒ Test Suite Manager
- Run Tests window: the Test Suites tab ⇒ the Open Test Suites Manager link,
- the Ctrl+R, Ctrl+M hotkey.
Below the current solution, there is a list of projects with available test suites. Next to the test suite's name you can see the number of test classes that are included in this suite. To get the newest list of test suites stored on your org, click the Refresh button.
Under the list of test suites, you can find the buttons with the actions for the test suites. Select a necessary suite (or at least — a project if you want to create a new suite) to make them active. The Test Suite Manager offers you the following options:
- Create — opens the Create new test suite window,
- Edit tests — allows adding or deleting classes in the selected test suite,
- Run — runs the selected test suite,
- Rename — allows changing a name of the selected test suite,
- Clone — duplicates the selected test suite,
- Delete — deletes the selected test suite.
The same set of actions, except creation, is available from the context menu of any test suite.
Creating a new test suite
To create a new test suite, open the Test Suite Manager, select a necessary project, where you want to add a test suite, and click the Create button.
In the opened window, enter a name for the new test suite, select needed test classes, and click the Apply button. The newly created test suite will appear in the list of test suites in the Test Suite Manager window.
For your convenience, you may use the filter input to quickly find a necessary test class. In addition, the buttons Select all and Select none below the list of available test classes will save your time.
NB: There are several rules for a name of a test suite: it can only contain underscores and alphanumeric characters; it must be unique, begin with a letter, not include spaces, not end with an underscore, and not to contain two consecutive underscores.
Running test suites
All your created test suites as well as saved test suites, that you created on your org, are presented in one list in the Test suites tab. You can easily open it in three ways:
- the Run Tests window
- the Main Menu:
Tests ⇒ Run test suites
- the Ctrl+R, Ctrl+Shift hotkey.
In addition, you can select which tab — 'Unit tests' or 'Test suites' — should be opened by default for you in the Run tests wizard. Navigate to the Options menu:
Main Menu ⇒ Tools ⇒ Options ⇒ Test, and change this setting to the preferable one.
The list of the test suites is presented in a tree view: the current solution is on the highest level, it includes projects; when you expand a project, you can see a list of available test suites. You are able to expand any test suite to see test classes that it includes. To find a necessary one you can use the Filter field.
Check the test suites that you want to run and click on the Run tests button. The process and the results of test runs are displayed in the Test Results panel.
Also, you can run several test suites enabling checkboxes for each of them. In the case, if some test suites contain the same classes, it will be run once.
In this section:
This also may be useful: