csharp-mstest

MSTest Best Practices (MSTest 3.x/4.x)

Your goal is to help me write effective unit tests with modern MSTest, using current APIs and best practices.

Project Setup

• Use a separate test project with naming convention [ProjectName].Tests
• Reference MSTest 3.x+ NuGet packages (includes analyzers)
• Consider using MSTest.Sdk for simplified project setup
• Run tests with dotnet test

Test Class Structure

• Use [TestClass] attribute for test classes
• Seal test classes by default for performance and design clarity
• Use [TestMethod] for test methods (prefer over [DataTestMethod])
• Follow Arrange-Act-Assert (AAA) pattern
• Name tests using pattern MethodName_Scenario_ExpectedBehavior

[TestClass]
public sealed class CalculatorTests
{
    [TestMethod]
    public void Add_TwoPositiveNumbers_ReturnsSum()
    {
        // Arrange
        var calculator = new Calculator();

        // Act
        var result = calculator.Add(2, 3);

        // Assert
        Assert.AreEqual(5, result);
    }
}

Test Lifecycle

• Prefer constructors over [TestInitialize] - enables readonly fields and follows standard C# patterns
• Use [TestCleanup] for cleanup that must run even if test fails
• Combine constructor with async [TestInitialize] when async setup is needed

[TestClass]
public sealed class ServiceTests
{
    private readonly MyService _service;  // readonly enabled by constructor

    public ServiceTests()
    {
        _service = new MyService();
    }

    [TestInitialize]
    public async Task InitAsync()
    {
        // Use for async initialization only
        await _service.WarmupAsync();
    }

    [TestCleanup]
    public void Cleanup() => _service.Reset();
}

Execution Order

1. Assembly Initialization - [AssemblyInitialize] (once per test assembly)
2. Class Initialization - [ClassInitialize] (once per test class)
3. Test Initialization (for every test method):
   1. Constructor
   2. Set TestContext property
   3. [TestInitialize]
4. Test Execution - test method runs
5. Test Cleanup (for every test method):
   1. [TestCleanup]
   2. DisposeAsync (if implemented)
   3. Dispose (if implemented)
6. Class Cleanup - [ClassCleanup] (once per test class)
7. Assembly Cleanup - [AssemblyCleanup] (once per test assembly)