Walkthrough: Test-driven development using Test Explorer

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

Create unit tests to help keep your code working correctly through incremental code changes. There are several frameworks that you can use to write unit tests, including some developed by third parties. Some test frameworks are specialized for testing in different languages or platforms. Test Explorer provides a single interface for unit tests in any of these frameworks. For more information about Test Explorer, see Run unit tests with Test Explorer and Test Explorer FAQ.

This walkthrough demonstrates how to develop a tested method in C# using Microsoft Test Framework (MSTest). You can easily adapt it for other languages or other test frameworks, such as NUnit. For more information, see Install third-party unit test frameworks.

Create a test and generate code

  1. Create a C# Class Library (.NET Standard) project. This project will contain the code that we want to test. Name the project MyMath.

  2. In the same solution, add a new MSTest test project.

    Starting in Visual Studio 2019 version 16.9, the MSTest project template name changed from MSTest Test Project (.NET Core) to Unit Test Project.

    Name the test project MathTests.

    New code and test projects

  3. Write a simple test method that verifies the result obtained for a specific input. Add the following code to the UnitTest1 class:

    [TestMethod]
    public void BasicRooterTest()
    {
      // Create an instance to test:
      Rooter rooter = new Rooter();
      // Define a test input and output value:
      double expectedResult = 2.0;
      double input = expectedResult * expectedResult;
      // Run the method under test:
      double actualResult = rooter.SquareRoot(input);
      // Verify the result:
      Assert.AreEqual(expectedResult, actualResult, delta: expectedResult / 100);
    }
    
  4. Generate a type from the test code.

    1. Place the cursor on Rooter, and then from the light bulb menu, choose Generate type 'Rooter' > Generate new type.

      Generate new type quick action

    2. In the Generate Type dialog box, set Project to MyMath, the class library project, and then choose OK.

      Generate Type dialog box in Visual Studio 2019

  5. Generate a method from the test code. Place the cursor on SquareRoot, and then from the light bulb menu, choose Generate method 'Rooter.SquareRoot'.

  6. Run the unit test.

    1. To open Test Explorer, on the Test menu, choose Windows > Test Explorer.

    2. In Test Explorer, choose the Run All button to run the test.

    The solution builds, and the test runs and fails.

  7. Select the name of the test.

    The details of the test appear in the Test Detail Summary pane.

    Test Detail Summary in Test Explorer

  8. Select the top link under Stack Trace to jump to the location where the test failed.

At this point, you've created a test and a stub that you can modify so that the test passes.

Verify a code change

  1. In the Class1.cs file, improve the code of SquareRoot:

    public double SquareRoot(double input)
    {
        return input / 2;
    }
    
  2. In Test Explorer, choose Run All.

    The solution builds, and the test runs and passes.

    Test Explorer showing a passing test

Extend the range of inputs

To improve our confidence that the code works in all cases, add tests that try a broader range of input values.

Tip

Avoid altering existing tests that pass. Instead, add new tests. Change existing tests only when the user requirements change. This policy helps to make sure that you don't lose existing functionality as you work to extend the code.

  1. In the test class, add the following test, which tries a range of input values:

    [TestMethod]
    public void RooterValueRange()
    {
        // Create an instance to test.
        Rooter rooter = new Rooter();
    
        // Try a range of values.
        for (double expected = 1e-8; expected < 1e+8; expected *= 3.2)
        {
            RooterOneValue(rooter, expected);
        }
    }
    
    private void RooterOneValue(Rooter rooter, double expectedResult)
    {
        double input = expectedResult * expectedResult;
        double actualResult = rooter.SquareRoot(input);
        Assert.AreEqual(expectedResult, actualResult, delta: expectedResult / 1000);
    }
    
  2. In Test Explorer, choose Run All.

    The new test fails (although the first test still passes). To find the point of failure, select the failing test, and then look at the details in the Test Detail Summary pane.

  3. Inspect the method under test to see what might be wrong. Alter the SquareRoot code as follows:

    public double SquareRoot(double input)
    {
      double result = input;
      double previousResult = -input;
      while (Math.Abs(previousResult - result) > result / 1000)
      {
        previousResult = result;
        result = result - (result * result - input) / (2 * result);
      }
      return result;
    }
    
  4. In Test Explorer, choose Run All.

    Both tests now pass.

Add tests for exceptional cases

  1. Add a new test for negative inputs:

    [TestMethod]
    public void RooterTestNegativeInputx()
    {
        Rooter rooter = new Rooter();
        try
        {
            rooter.SquareRoot(-10);
        }
        catch (System.ArgumentOutOfRangeException)
        {
            return;
        }
        Assert.Fail();
    }
    
  2. In Test Explorer, choose Run All.

    The method under test loops and must be canceled manually.

  3. Choose Cancel on the toolbar of Test Explorer.

    The test stops executing.

  4. Fix the SquareRoot code by adding the following if statement at the beginning of the method:

    public double SquareRoot(double input)
    {
        if (input <= 0.0)
        {
            throw new ArgumentOutOfRangeException();
        }
        ...
    
  5. In Test Explorer, choose Run All.

    All the tests pass.

Refactor the code under test

Refactor the code, but do not change the tests.

Tip

A refactoring is a change that is intended to make the code perform better or easier to understand. It is not intended to alter the behavior of the code, and therefore the tests are not changed.

We recommend that you perform refactoring steps separately from steps that extend functionality. Keeping the tests unchanged gives you confidence that you have not accidentally introduced bugs while refactoring.

  1. Change the line that calculates result in the SquareRoot method as follows:

    public double SquareRoot(double input)
    {
        if (input <= 0.0)
        {
            throw new ArgumentOutOfRangeException();
        }
    
        double result = input;
        double previousResult = -input;
        while (Math.Abs(previousResult - result) > result / 1000)
        {
            previousResult = result;
            result = (result + input / result) / 2;
            //was: result = result - (result * result - input) / (2*result);
        }
        return result;
    }
    
  2. Choose Run All, and verify that all the tests still pass.

    Test Explorer showing 3 passed tests