Microsoft.AspNetCore.TestHost 10.0.0-preview.5.25277.114

About

Microsoft.AspNetCore.TestHost provides an ASP.NET Core web server for testing middleware in isolation.

Key Features

  • Instantiate an app pipeline containing only the components that you need to test
  • Send custom requests to verify middleware behavior

How to Use

To use Microsoft.AspNetCore.TestHost, follow these steps:

Installation

dotnet add package Microsoft.AspNetCore.TestHost

Usage

To set up the TestServer, configure it in your test project. Here's an example:

[Fact]
public async Task MiddlewareTest_ReturnsNotFoundForRequest()
{
    // Build and start a host that uses TestServer
    using var host = await new HostBuilder()
        .ConfigureWebHost(builder =>
        {
            builder.UseTestServer()
                .ConfigureServices(services =>
                {
                    // Add any required services that the middleware uses
                    services.AddMyServices();
                })
                .Configure(app =>
                {
                    // Configure the processing pipeline to use the middleware
                    // for the test
                    app.UseMiddleware<MyMiddleware>();
                });
        })
        .StartAsync();

    var response = await host.GetTestClient().GetAsync("/");

    Assert.Equal(HttpStatusCode.NotFound, response.StatusCode);
}

Main Types

The main types provided by this package are:

  • TestServer: An IServer implementation for executing tests
  • TestServerOptions: Provides options for configuring a TestServer

Additional Documentation

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

Feedback & Contributing

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

Showing the top 20 packages that depend on Microsoft.AspNetCore.TestHost.

Packages Downloads
Microsoft.AspNetCore.Mvc.Testing
Support for writing functional tests for MVC applications. This package was built from the source code at https://github.com/aspnet/AspNetCore/tree/4768f164d522e128f91827810527730f7468fd74
16
Microsoft.AspNetCore.Mvc.Testing
Support for writing functional tests for MVC applications. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/b92c9f50f0333ea661785ba849f303cde6a93844
16
Microsoft.AspNetCore.Mvc.Testing
Support for writing functional tests for MVC applications. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/3b519aa7d1a1b66e1d329d694f814e1d8228dc8c
16
Microsoft.AspNetCore.Mvc.Testing
Support for writing functional tests for MVC applications. This package was built from the source code at https://github.com/aspnet/AspNetCore/tree/21d42143378ad6cc4bcbaebfda5f3acddf13aa47
16
Microsoft.AspNetCore.Mvc.Testing
Support for writing functional tests for MVC applications. This package was built from the source code at https://github.com/aspnet/AspNetCore/tree/1bf292d47ac2a0ebda07d8a3f00355dd01915ad5
15
Microsoft.AspNetCore.Mvc.Testing
Support for writing functional tests for MVC applications. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/2670c128d522473e146ff9f8159bfffdfe694cd9
15
Microsoft.AspNetCore.Mvc.Testing
Support for writing functional tests for MVC applications. This package was built from the source code at https://github.com/aspnet/AspNetCore/tree/458d97420a173fe87487b58ec4aa47a4c9dc4710
15
Microsoft.AspNetCore.Mvc.Testing
Support for writing functional tests for MVC applications. This package was built from the source code at https://github.com/aspnet/AspNetCore/tree/561deb05ae2d6680206e3d4a6bc75de699585980
15
Microsoft.AspNetCore.Mvc.Testing
Support for writing functional tests for MVC applications. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/d827c653b787c07de908240b7746ce34d3e6271e
15
Microsoft.AspNetCore.Mvc.Testing
Support for writing functional tests for MVC applications.
15
Microsoft.AspNetCore.Mvc.Testing
Support for writing functional tests for MVC applications. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/371a26f07b23ad77c636332c2dfc0cbd1d8137ba
15
Microsoft.AspNetCore.Mvc.Testing
Support for writing functional tests for MVC applications. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/c911002ab43b7b989ed67090f2a48d9073d5118d
15
Microsoft.AspNetCore.Mvc.Testing
Support for writing functional tests for MVC applications. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/54142bcb25544b72fac28b1b061e7788c91c4f49
15
Microsoft.AspNetCore.Mvc.Testing
Support for writing functional tests for MVC applications. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/e882394a7bb38930da748291fe2c2ceaa6a80588
15
Microsoft.AspNetCore.Mvc.Testing
Support for writing functional tests for MVC applications. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/54e8b61777d42d2b10744d1987438ee5b8c0b24d
15
Microsoft.AspNetCore.Mvc.Testing
Support for writing functional tests for MVC applications. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/773e8cc3fbdc2c4ffbd57c1f53f21649ef94c35c
15
Microsoft.AspNetCore.Mvc.Testing
Support for writing functional tests for MVC applications. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/36f34b3a19eb7219142ab2035921d08e84c572c3
15
Microsoft.AspNetCore.Mvc.Testing
Support for writing functional tests for MVC applications. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/d47e49e9c1e173ac90821f7e89cc38e710274241
15
Microsoft.AspNetCore.Mvc.Testing
Support for writing functional tests for MVC applications. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/c9e3996173cec136bc2e9f3b4ec45f2a323b1d63
15

.NET 10.0

  • No dependencies.

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