Microsoft.AspNetCore.Mvc.Testing 10.0.0-preview.2.25164.1

About

Microsoft.AspNetCore.Mvc.Testing provides support for writing integration tests for ASP.NET Core apps that utilize MVC or Minimal APIs.

Key Features

  • Copies the dependencies file (.deps.json) from the System Under Test (SUT) into the test project's bin directory
  • Sets the content root to the SUT's project root so that static files are found during test execution
  • Provides the WebApplicationFactory class to streamline bootstrapping the SUT with TestServer

How to Use

To use Microsoft.AspNetCore.Mvc.Testing, follow these steps:

Installation

To install the package, run the following command from the directory containing the test project file:

dotnet add package Microsoft.AspNetCore.Mvc.Testing

Configuration

To configure the test app, follow these steps:

  1. Specify the Web SDK in the test project file (<Project Sdk="Microsoft.NET.Sdk.Web">).
  2. Add references to the following packages:
    • xunit
    • xunit.runner.visualstudio
    • Microsoft.NET.Test.Sdk
  3. Add a test class to the test project:
    public class BasicTests
        : IClassFixture<WebApplicationFactory<Program>>
    {
        private readonly WebApplicationFactory<Program> _factory;
    
        public BasicTests(WebApplicationFactory<Program> factory)
        {
            _factory = factory;
        }
    
        [Theory]
        [InlineData("/")]
        [InlineData("/Index")]
        [InlineData("/About")]
        [InlineData("/Privacy")]
        [InlineData("/Contact")]
        public async Task Get_EndpointsReturnSuccessAndCorrectContentType(string url)
        {
            // Arrange
            var client = _factory.CreateClient();
    
            // Act
            var response = await client.GetAsync(url);
    
            // Assert
            response.EnsureSuccessStatusCode(); // Status Code 200-299
            Assert.Equal("text/html; charset=utf-8",
                response.Content.Headers.ContentType.ToString());
        }
    }
    

Additional Documentation

For additional documentation and examples, refer to the official documentation on integration testing in ASP.NET Core.

Feedback & Contributing

Microsoft.AspNetCore.Mvc.Testing is released as open-source under the MIT license. Bug reports and contributions are welcome at the GitHub repository.

No packages depend on Microsoft.AspNetCore.Mvc.Testing.

.NET 10.0

Version Downloads Last updated
10.0.0-preview.2.25164.1 1 04/01/2025
10.0.0-preview.1.25120.3 2 02/26/2025
9.0.3 1 04/01/2025
9.0.2 2 02/19/2025
9.0.1 3 01/18/2025
9.0.0 4 01/19/2025
9.0.0-rc.2.24474.3 1 03/05/2025
9.0.0-rc.1.24452.1 2 01/18/2025
9.0.0-preview.7.24406.2 2 01/19/2025
9.0.0-preview.6.24328.4 3 01/19/2025
9.0.0-preview.5.24306.11 3 01/19/2025
9.0.0-preview.4.24267.6 2 01/19/2025
9.0.0-preview.3.24172.13 2 01/19/2025
9.0.0-preview.2.24128.4 4 03/28/2024
9.0.0-preview.1.24081.5 4 03/07/2024
8.0.14 1 04/01/2025
8.0.13 3 02/19/2025
8.0.12 3 01/19/2025
8.0.11 3 01/19/2025
8.0.10 3 01/19/2025
8.0.8 4 01/18/2025
8.0.7 3 01/18/2025
8.0.6 3 01/19/2025
8.0.5 3 01/19/2025
8.0.4 3 01/19/2025
8.0.3 6 03/29/2024
8.0.2 7 03/02/2024
8.0.1 7 03/16/2024
8.0.0 6 03/01/2024
8.0.0-rc.2.23480.2 6 03/06/2024
8.0.0-rc.1.23421.29 3 02/29/2024
8.0.0-preview.7.23375.9 4 03/06/2024
8.0.0-preview.6.23329.11 4 03/02/2024
8.0.0-preview.5.23302.2 4 03/07/2024
8.0.0-preview.4.23260.4 4 03/03/2024
8.0.0-preview.3.23177.8 4 03/07/2024
8.0.0-preview.2.23153.2 3 03/02/2024
8.0.0-preview.1.23112.2 5 03/07/2024
7.0.20 3 01/19/2025
7.0.19 4 01/18/2025
7.0.18 4 01/19/2025
7.0.17 7 03/28/2024
7.0.16 5 02/29/2024
7.0.15 6 03/06/2024
7.0.14 6 03/01/2024
7.0.13 7 02/20/2024
7.0.12 6 03/06/2024
7.0.11 6 12/04/2023
7.0.10 6 03/07/2024
7.0.9 6 03/02/2024
7.0.8 7 03/07/2024
7.0.7 6 11/03/2023
7.0.5 7 03/06/2024
7.0.4 6 03/01/2024
7.0.3 5 03/16/2024
7.0.2 6 03/06/2024
7.0.1 6 03/06/2024
7.0.0 7 03/02/2024
7.0.0-rc.2.22476.2 5 11/05/2023
7.0.0-rc.1.22427.2 5 03/07/2024
7.0.0-preview.7.22376.6 5 03/03/2024
7.0.0-preview.6.22330.3 5 03/06/2024
7.0.0-preview.5.22303.8 3 03/07/2024
7.0.0-preview.4.22251.1 5 03/07/2024
7.0.0-preview.3.22178.4 5 03/07/2024
7.0.0-preview.2.22153.2 6 03/07/2024
7.0.0-preview.1.22109.13 5 03/07/2024
6.0.36 3 01/19/2025
6.0.35 3 01/18/2025
6.0.33 4 01/19/2025
6.0.32 3 01/19/2025
6.0.31 4 01/19/2025
6.0.30 4 01/18/2025
6.0.29 5 01/19/2025
6.0.28 5 03/29/2024
6.0.27 5 03/13/2024
6.0.26 6 03/01/2024
6.0.25 6 03/22/2024
6.0.24 6 02/08/2024
6.0.23 7 03/27/2024
6.0.22 7 11/03/2023
6.0.21 6 11/06/2023
6.0.20 6 03/01/2024
6.0.19 7 02/08/2024
6.0.18 7 03/02/2024
6.0.16 7 02/08/2024
6.0.15 6 03/06/2024
6.0.14 8 11/04/2023
6.0.13 7 01/25/2024
6.0.12 7 11/05/2023
6.0.11 7 11/05/2023
6.0.10 6 03/01/2024
6.0.9 7 11/03/2023
6.0.8 9 08/18/2023
6.0.7 6 03/02/2024
6.0.6 6 03/06/2024
6.0.5 6 01/28/2024
6.0.4 6 03/03/2024
6.0.3 5 03/14/2024
6.0.2 7 03/07/2024
6.0.1 6 03/01/2024
6.0.0 6 03/06/2024
6.0.0-rc.2.21480.10 5 03/17/2024
6.0.0-rc.1.21452.15 4 03/16/2024
6.0.0-preview.7.21378.6 4 03/07/2024
6.0.0-preview.6.21355.2 4 11/03/2023
6.0.0-preview.5.21301.17 5 03/07/2024
6.0.0-preview.4.21253.5 4 03/02/2024
6.0.0-preview.3.21201.13 2 01/19/2025
6.0.0-preview.2.21154.6 4 03/07/2024
6.0.0-preview.1.21103.6 3 11/02/2023
5.0.17 6 03/06/2024
5.0.16 7 03/06/2024
5.0.15 7 03/06/2024
5.0.14 7 11/06/2023
5.0.13 6 11/03/2023
5.0.12 6 03/07/2024
5.0.11 6 03/07/2024
5.0.10 6 11/13/2023
5.0.9 6 03/07/2024
5.0.8 7 03/07/2024
5.0.7 6 03/07/2024
5.0.6 6 03/07/2024
5.0.5 6 03/03/2024
5.0.4 6 03/06/2024
5.0.3 6 03/06/2024
5.0.2 6 03/07/2024
5.0.1 6 03/02/2024
5.0.0 7 03/01/2024
5.0.0-rc.2.20475.17 3 03/02/2024
5.0.0-rc.1.20451.17 5 03/07/2024
5.0.0-preview.8.20414.8 4 03/07/2024
5.0.0-preview.7.20365.19 4 03/02/2024
5.0.0-preview.6.20312.15 4 03/07/2024
5.0.0-preview.5.20279.2 4 03/07/2024
5.0.0-preview.4.20257.10 4 03/07/2024
5.0.0-preview.3.20215.14 4 03/07/2024
5.0.0-preview.2.20167.3 4 03/07/2024
5.0.0-preview.1.20124.5 4 03/07/2024
3.1.32 6 03/06/2024
3.1.31 6 03/06/2024
3.1.30 6 01/06/2024
3.1.29 7 03/01/2024
3.1.28 6 11/05/2023
3.1.27 6 03/06/2024
3.1.26 6 03/06/2024
3.1.25 6 03/02/2024
3.1.24 5 03/06/2024
3.1.23 6 11/05/2023
3.1.22 7 11/04/2023
3.1.21 6 03/06/2024
3.1.20 6 03/03/2024
3.1.19 7 01/25/2024
3.1.18 6 03/02/2024
3.1.17 5 11/04/2023
3.1.16 7 03/03/2024
3.1.15 6 03/02/2024
3.1.14 6 03/02/2024
3.1.13 6 03/03/2024
3.1.12 7 03/03/2024
3.1.11 5 11/03/2023
3.1.10 6 03/06/2024
3.1.9 6 03/06/2024
3.1.8 5 03/03/2024
3.1.7 7 03/01/2024
3.1.6 6 03/03/2024
3.1.5 6 11/03/2023
3.1.4 6 03/06/2024
3.1.3 7 03/03/2024
3.1.2 6 11/05/2023
3.1.1 7 03/03/2024
3.1.0 6 03/01/2024
3.1.0-preview3.19555.2 5 03/07/2024
3.1.0-preview2.19528.8 4 03/02/2024
3.1.0-preview1.19508.20 5 03/07/2024
3.0.3 6 01/26/2024
3.0.2 7 11/04/2023
3.0.0 6 03/03/2024
3.0.0-rc1.19457.4 5 03/07/2024
3.0.0-preview9.19424.4 5 03/07/2024
3.0.0-preview8.19405.7 3 01/19/2025
3.0.0-preview7.19365.7 2 01/19/2025
3.0.0-preview6.19307.2 5 03/02/2024
3.0.0-preview5-19227-01 3 03/07/2024
3.0.0-preview4-19216-03 4 03/07/2024
3.0.0-preview3-19153-02 5 03/02/2024
3.0.0-preview-19075-0444 4 03/07/2024
3.0.0-preview-18579-0056 7 03/07/2024
2.3.0 3 01/19/2025
2.2.0 6 12/05/2023
2.2.0-preview3-35497 4 03/08/2024
2.2.0-preview2-35157 4 03/02/2024
2.2.0-preview1-35029 5 03/06/2024
2.1.3 6 03/06/2024
2.1.2 6 01/24/2024
2.1.1 6 11/02/2023
2.1.0 6 03/02/2024
2.1.0-rc1-final 6 03/06/2024
2.1.0-preview2-final 6 03/06/2024
2.1.0-preview1-final 5 03/06/2024