JetBrains Rider
 
2024.3
Shortcuts: Visual Studio 2022 (Windows)
Get JetBrains Rider
  1. Run, debug, test, deploy
  2. Unit testing
  3. Unit Tests window

Unit Tests window

Last modified: 17 May 2024

View | Tool Windows | Unit Tests

Alt08

This window lets you manage all your unit testing activities in different tabs.

To search tests, start typing a test name or its CamelHumps abbreviation as soon as your focus is in this window.

To cycle through the tool window tabs, press CtrlAltPg Dn and CtrlAltPg Up.

Explorer tab

Using this tab, you can explore and run, debug, or cover unit tests of all supported frameworks in the entire solution. Note that unit tests from a project only appear in the tab after the project is built. Tests from currently opened files are updated automatically, new tests from the opened files appear in the unit test explorer as soon as you create them.

Unit Test Explorer displays tests from the entire solution

When the Explorer tab, or any unit test session tab is open, you can use the following controls on the toolbars:

Left Toolbar

Control

Name

Description

Run All Tests CtrlShiftEnter

Runs all tests in the tree.

You can use the integrated drop-down selector for other actions

ThemedIcon.CoverAll.Screen.(Gray).png

Cover Current Session

Runs coverage analysis for all unit tests in the test session.

ThemedIcon.UtrProfileAll.Screen.(Gray).png

Profile Current Session

Starts performance profiling for all tests in the current session.

Run All Tests under dotMemory Unit

Runs all tests in the current tree with dotMemory Unit enabled. Use this button to run tests that use dotMemory Unit framework to check code for memory issues.

Run Selected Tests ShiftEnter

Runs selected tests. To select multiple tests, click them holding the Ctrl key.

You can use the integrated drop-down selector for other actions on the selected tests:

ThemedIcon.Cover.Screen.(Gray).png

Cover Selected Tests

By clicking this button, you can start code coverage of the selected tests.

ThemedIcon.UtrProfile.Screen.(Gray).png

Profile Unit Tests

By clicking this button, you can profile selected tests.

ThemedIcon.DotMemoryUnitRun.Screen.(Gray).png

Run Unit Tests under dotMemory Unit Ctrl0U,0M

Runs selected tests with dotMemory Unit enabled. Use this button to run tests that use dotMemory Unit framework to check code for memory issues.

Run Selected Tests Until Failure

Click this button to keep automatically starting and running selected tests until one of the tests fails.

Debug Selected Tests Ctrl0U,0D

Starts debugging for selected tests in the current session.

Top Toolbar

Control

Name

Description

Import Session

Click to open a test session that you have previously saved in a .testsession file.

ThemedIcon.ExpandAll.Screen.(Gray).png ThemedIcon.CollapseAll.Screen.(Gray).png

Expand All/Collapse All


CtrlNumPad +/CtrlNumPad -

Expands/collapses all nodes in the current tab.

Group by

Allows grouping items in the window by different categories.

ThemedIcon.Up.Screen.(Gray).png ThemedIcon.Down.Screen.(Gray).png

Previous/Next


ShiftF8/ F8

Navigate to the previous/next item and scrolls through the source code accordingly.

ThemedIcon.Settings.Screen.(Gray).png

Unit Test Settings

Opens the Build, Execution, Deployment | Unit Testing page of JetBrains Rider settings , where you can configure all settings related to unit testing.

Unit test sessions tabs

These tabs appear each time you run tests from the current document or from the project or solution. For every new combination of tests (unit test session), a new tab opens.

These tabs are designed to help you run any number of unit test sessions, simultaneously and independently of each other. Sessions can be composed of any combination of tests. In the debugging mode, only one session can be run at a time.

The unit test tree shows the structure of tests belonging to a session, which you can filter to show only passed, failed or ignored unit tests. You can navigate to the code of any unit test by double-clicking it.

A unit test session displayed in the Unit Tests window

When a unit test session tab is open, you can additionally use the following controls on the toolbars:

Left Toolbar

Control

Name

Description

ThemedIcon.Rerun.Screen.(Gray).png

Repeat Previous Run Ctrl0U,0U

Repeats the previous test run.

icon_rerun_failed_tests.png

Rerun Failed Tests Ctrl0U,0F

Starts execution of tests that failed in the previous run.

ThemedIcon.StopTest.Screen.(Gray).png

Stop Execution

Stops the current test session.

Top Toolbar

Control

Name

Description

ThemedIcon.StatusAll.Screen.(Gray).png

All Tests

Show all tests in the current test session.

ThemedIcon.Success.Screen.(Gray).png

Passed Tests

Only show successful tests and hide all other tests.

ThemedIcon.StatusFailedPassive.Screen.(Gray).png

Failed Tests

Only show failed tests and hide all other tests.

ThemedIcon.Ignore.Screen.(Gray).png

Ignored Tests

Only show ignored tests and hide all other tests. A test is ignored if it has the corresponding attribute, or if the whole category where it belongs is ignored.

icon_broken_tests.png

Broken Tests

Only show broken tests. A test is considered broken if it was started but JetBrains Rider could not read the test runner output. This normally happens when you abort test execution, but could also be a sign of an error occurring in the test runner.

icon_toggle_output_position.png

Toggle Output Position

Use this button to change the position (right or bottom) of the output pane, which lets you analyze test results and navigate from a failed test's output to the code lines that originated the assertion or exception.

Session Options

You can configure this set of preferences individually for each test session.

  • Build Policy — Specifies whether building is required before executing tests. Provides several options:

    • Automatic (selected by default) — Before executing tests, JetBrains Rider will rebuild all projects that are related to the current test session and that have changes since the last execution.

    • Whole Solution — Before executing tests, JetBrains Rider will rebuild all projects in your solution that have changes since the last execution.

    • Never — JetBrains Rider will not build anything before executing tests. If you choose this option, you will have to make sure all related projects are built.

  • ThemedIcon.LockSession.Screen.(Gray).png Lock Session — Locks the current test session to prevent automatically adding new tests to this session.

  • Show Time — Allows you to show or hide execution time for each item in the test session.

  • Platform — Lets you explicitly specify platform architecture (x86 or x64) of the test runner or choose Automatic to use platform architecture corresponding to the project settings.

  • Target Framework — Lets you explicitly specify the .NET framework (CLR) version of the test runner or choose Automatic to use the latest installed version.

  • Diagnostics — Click this button to open the log of the last executed test session.

Title bar context menu and buttons

You can right-click the window header and use the context menu to configure its viewing mode, associate the window with a different tool window bar, or resize and hide the window.

You can also use the toolbar buttons:

Item

Shortcut

Description

Hide tool window

ShiftEsc

Hide the tool window .

To hide all the tool windows, press .