Legacy Documentation. View NUnit 3 Documentation

Options Dialog

The Options Dialog is displayed using the Tools | Options menu item and allows the user to control some aspects of NUnit's operation.


General Options


Recent Files

The text box allows the user to choose the number of entries to display in the recent files list. If Load most recent project at startup is checked, the GUI will load the last file opened unless it is run with a specific filename or with the /noload parameter.

Tree View

The list box allows selecting the degree of expansion of the tree when tests are loaded:

Expand - expands all tests

Collapse - collapses all tests

Hide Tests - expands all suites except for the fixtures themselves.

Auto - selects one of the above based on the space available for the tree display.

If Clear results when reloading is checked, an automatic or manual reload will reinitialize all test nodes in the tree (grey display) - if it is not checked, result information for tests that do not seem to have changed will be retained.

If Save visual state of each project is checked, NUnit saves the state of the tree and restores it when the project is next opened. The information saved includes which branches of the tree are expanded, the selected node, any checked nodes and any category selection.

Visual Studio

If Enable Visual Studio Support is checked, the user will be able to open Visual Studio projects and solutions and add Visual Studio projects to existing test projects.

Shadow Copy

NUnit normally uses .Net shadow-copying in order to allow you to edit and recompile assemblies while it is running. Uncheck this box to disable shadow-copy only if you have a particular problem that requires it.

Note: If you are tempted to disable shadow copy in order to access files in the same directory as your assembly, you should be aware that there are alternatives. Consider using the Assembly.Codebase property rather than Assembly.Location.


Test Load Options


Test Structure

If Automatic Namespace suites is selected, tests will be shown in a hierarchical listing based on namespaces. This is the standard display as used in versions prior to NUnit 2.4.

If Flat list of TestFixtures is selected, tests will be shown as a sequential list of fixtures.

Multiple Assemblies

If Load in separate AppDomains is selected, each assembly in a multiple-assembly test run will be loaded in a separate AppDomain.

If Load in a single AppDomain is selected, all assemblies in a multiple-assembly test run will use the same AppDomain. This is the standard behavior of NUnit prior to version 2.4.

If Merge tests across assemblies is checked, the display of tests will not be divided across assemblies. If automatic namespace suites are used, they will be merged across all assemblies. This option is only available when tests are run in the same appdomain.

Assembly Reload

If Reload before each test run is checked, a reload will occur whenever the run button is pressed whether the assemblies appear to have changed or not.

If Reload when test assembly changes is checked, assemblies are watched for any change and an automatic reload is initiated. This item is disabled on Windows 98 or ME.

If Re-run tests automatically is checked, tests are re-run whenever a Reload takes place.


Test Output Options


Test Results

Check Display Errors and Failures to display the Errors and Failures tab, which shows information about failing tests.

Check Display Failure ToolTips to display the tip window over the Errors and Failures display and the stack trace. Clear it if you prefer not to see the tip window.

Check Enable Word Wrap in Error Display to turn on word wrapping in the Errors and Failures display. While you can select this item and the preceding one at the same time, they do not interact well, so you will normally choose one or the other.

Check Display Tests Not Run to display the Tests Not Run tab, which shows information about tests that were skipped or ignored.

Test Output

Check Display Console Standard Output to display the Console.Out tab, which shows text written to the Console by your tests.

Check Label Test Cases to precede text in the output window with the name of the test that produced it.

Check Display Console Error Output to display text written to Console.Error by your tests.

Select In Separate Tab to show error output in the Console.Error tab.

Select Merge with Console Output to hide the Console.Error tab and display error output in the Console.Out tab.

Check Display Trace Output to display trace output written by your tests.

Select In Separate Tab to show trace output in the Trace Output tab.

Select Merge with Console Output to hide the Trace Output tab and display trace output in the Console.Out tab.