Microsoft.AspNetCore.Testing

Microsoft.AspNetCore.Testing

This package provides test fakes for integration testing of ASP.NET Core applications.

In particular:

• IWebHostBuilder extensions to setup the test web app.
• IHost extensions to access that test web app.

Install the package

From the command-line:

dotnet add package Microsoft.AspNetCore.Testing

Or directly in the C# project file:

<ItemGroup>
  <PackageReference Include="Microsoft.AspNetCore.Testing" Version="[CURRENTVERSION]" />
</ItemGroup>

Usage Example

Creating a Test Web App

The IWebHostBuilder extensions can help set up a host for testing.

using var host = await FakeHost.CreateBuilder()
    .ConfigureWebHost(webHost => webHost.UseFakeStartup().ListenHttpOnAnyPort())
    .StartAsync();

Accessing the test Web App

The IHost extensions can help access the test host that was created above.

using var client = host.CreateClient();

var response = await client.GetAsync("/");

Feedback & Contributing

We welcome feedback and contributions in our GitHub repo.