dotCover Web Help

dotCover | Windows | Unit Test Sessions
dotCover | Unit Tests | Unit Test Sessions


dotCover shares the unit test support with another JetBrains .NET developer tool, ReSharper. These two tools have the same unit test runner engines as well as Unit Test Explorer and Unit Test Sessions windows. If you install dotCover after ReSharper, dotCover disables its own unit test runner so that you can continue using ReSharper's unit test commands and windows; all additional dotCover commands are integrated in ReSharper menus. For more information, see Sharing Unit Test Support with ReSharper.

dotCover runs unit tests in the Unit Test Sessions window. The window appears automatically when you run tests from the editor or from Solution Explorer. For more information, see Working with Unit Tests.

Unit Test Sessions window

The window is designed to help you run any number of unit test sessions, independently of each other, as well as simultaneously. 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.

The progress bar and the status bar display the current progress. You can stop, run or re-build and re-run unit tests at any time.

Using the Show Output toolbar_show_preview selector, you can open the Output and the Coverage panes and place them to the bottom or to the right of the window.

Output pane

The Output pane lets you analyze test results and navigate from a failed test's output to the code lines that originated the exception, all with a single click.

Coverage pane

The Coverage pane displays the code coverage tree or the hot spots view and provides the same controls and functions as Coverage Results Browser, plus the Show coverage for selected tests icon_show_coverage_for_selected_test button that allows Viewing Total Coverage of Particular Unit Test Item.

Toolbar controls

Control Name Description
uts_toolbar_rerun Repeat Previous Run Repeats the previous test run.
uts_toolbar_run_all_tests Run All Tests

Runs all tests in the current session.

icon_cover_all Cover All Tests with dotCover By clicking this button, you can run coverage analysis for all unit tests in the test session.
toolbar__run_selected_tests Run Selected Tests Runs selected tests. To select multiple texts, use the Ctrl key.
uts_toolbar_debug_selected_tests Debug Unit Tests Debugs selected tests in the current session.
uts_toolbar_cover Cover Selected Tests By clicking this button, you can perform code coverage on the selected tests.
uts_toolbar_stop_execution Stop Execution Stops the current test session.
uts_toolbar_show_all_tests Show All Tests Shows successful, failed, and ignored tests in the tree view.
uts_toolbar_show_only_failed_tests Show Only Failed Tests Hides anything but failed tests from the tree view.
uts_toolbar_show_only_ignored_tests Show Only Ignored Tests Hides anything but ignored tests from the tree view.
toolbar__filter_usages Filter Tests Allows choosing any combination of test results (successful, failed, or ignored) to display.
uts_toolbar_build_settings Build Settings Specifies whether building is required before running tests. Provides three options:
  • Automatic (selected by default).
  • Always Build
  • Never Build
uts_toolbar_track_running_test Track Running Test Specifies whether dotCover should select test entries when the corresponding tests are executed.
toolbar__remove Remove Selected Tests Removes selected tests from the current session.
uts_toolbar_lock_session Lock Session Locks the current test session to prevent extending it with new tests.
toolbar__time Show Time Specifies whether to show the duration time of the last execution for items in the tree.
A test run duration is calculated as the execution time of the test method itself (marked with [TestMethod] attribute in case of MSTest, or with [Test] attribute in case of NUnit, etc.) plus all related methods (e.g. for MSTest - [TestInitialize], [TestCleanup], etc.).
toolbar__expand_all toolbar__collapse_all Expand All/Collapse All Expands/collapses all nodes in the current tab.
toolbar__previous toolbar__next Previous/Next Navigate to the previous/next item and scrolls through the source code accordingly.
toolbar_show_preview Show Output Specifies whether the preview pane should be displayed, and offers two alternative positions: below or to the right of the tree view.
toolbar__export Export Click this button to export the data currently displayed in the window in text format, or use the drop-down selector to export the data in XML or HTML format. The Export Data dialog box that appears, will help you to save the data to a file or copy it to the clipboard.

Group by Allows grouping items in the window. Possible options help display items as a tree grouped by the selected categories.
tab_close Close Closes the current tab.