Unit test sessions
tip
dotCover's unit test runner does not allow running two or more tests with the same ID. This rarely happens in practice, but if you do have tests with the same ID, they will appear as a single node in the Unit Tests explorer and Unit Test Sessions window, and only one of them will run.
Note that test frameworks identify tests in different ways. For example, MSTest uses test-methods FQNs but NUnit uses properties of test attributes as test IDs.
note
If execution settings are different in different unit test sessions, it is possible that a test passes in one session and fails in another. Therefore, dotCover does not update execution results in other sessions, where the same tests are added. Also, the execution status icon displayed for a test in the editor corresponds to the result from the test session where it was last executed.
Just run, debug or cover unit tests from the current document or from the project/solution. If there is an open unit test session, the executed tests are added to that session. If there are no test sessions or the existing ones are locked, then a new tests session is created.
In the editor, click an action indicator next to a test or test class , and then choose Create New Session in the action list. A new session with this test/test class will be created.
In the Unit Test Explorer window, select tests/test classes for the new session and choose Create New Session
.png "ThemedIcon.NewSession.Screen.(Gray).png")
from the context menu or press .From the main menu, choose or press . If the focus is in the editor or in the Unit Test Explorer window and some tests/test classes are selected, or the caret is at or inside a test/test class, the new test session is created with the corresponding items. Otherwise, an empty test session is created.
In the editor, click an action indicator next to a test or test class , and then choose Append to [current session] in the action list. If you want to add the item to another section, click the small arrow next to this command and choose any of the existing test sessions in a sub-menu:
You can also choose in the main menu or press to add the selected items to a session.
In the Unit Test Explorer window, select tests/test classes that you want to add and click Append Tests to Session
.png "ThemedIcon.AddedParameter.Screen.(Gray).png")
on the toolbar or press . If there are more than one session, choose the target session in the popup that appears.
To remove tests from the session, select the tests or grouping items that you want to remove and click Remove Selected Tests .png "ThemedIcon.Remove.Screen.(Gray).png"){kind=icon}
on the toolbar.
If necessary, you can prevent adding new tests to a session. To do so, in the Unit Test Sessions window switch to the tab of the session that you want to lock, click Options on the toolbar, and then select Lock Session .png "Lock Session"){kind=icon}
.
If necessary, you can also save any test session in a file and then open it when needed. To save a session, select the corresponding tab in the Unit Test Sessions window and click Export Session .png "ThemedIcon.Export.Screen.(Gray).png"){kind=icon}
on the toolbar and then choose where to save the session file.
To open a saved session, click Import Session .png "ThemedIcon.Import.Screen.(Gray).png"){kind=icon}
in the Unit Test Explorer or Unit Test Sessions window and then select a .testsession file.