dotCover 2023.3 Help

Test categories

NUnit, MSTest, and xUnit frameworks allow grouping tests and test classes into suites with the Category (NUnit) or TestCategory (MSTest) attribute on the corresponding symbols. xUnit provides the Trait attribute with the similar functionality. dotCover is aware of these attributes and provides a number of related features.

Browse Test Categories

In the Unit Test Explorer window, you can explore all existing categories in the current solution. To do so, in the Group by selector, choose Categories or Project and Categories. It is also possible to explore categories within a session in the Unit Test Sessions window. You can find the same grouping preferences under the Options selector.

Execute all tests in a category

From each test/test class belonging to some category, you can start execution of all tests in this category. To do so, press Alt+Enter or click the action indicator, choose Run/Debug or Run All/Debug All or Cover/Cover ALl in the action list, and then click the small arrow on the right and click the category name or press Enter:

dotCover: Executing unit tests in a category

Another option to run all tests in a category is to group tests by category in the Unit Test Explorer window, choose the category node, and then click Run Unit Tests Run Unit Tests Control+T, R / Debug Unit Tests Debug Unit Tests Control+T, D or Cover Unit Tests Cover Unit Tests Control+T, H on the toolbar.

Ignore categories

If necessary, you can add one or more categories to the ignore list. All tests belonging to these categories will be skipped during the execution of a unit test session. Note that you can still run specific tests from ignored categories individually.

To add a category to the ignore list, type the category name into the Skip tests from categories field on the Tools | Unit Testing | General page of dotCover options ( Alt+R, O ). If you enter multiple categories, use comma as the delimiter.

For XUnit tests, where there is no special attribute for categories, list the ignored categories as follows:

  • For attributes like [Trait("One", "Two")], add One [Two] in the settings field.

  • If the first argument of the attribute is Category, for example [Trait("Category", "Three")], then you can add it as Three in the settings field.

Last modified: 01 September 2023