.NET Разработчик(@NetDeveloperDiary). День 1405. #МоиИнструменты Интеграционные Тесты ASP.NET Core с Помощью Alba Alba

День 1405. #МоиИнструменты Интеграционные Тесты ASP.NET Core с Помощью Alba Alba — это небольшая библиотека, которая обеспечивает простое интеграционное тестирование маршрутов ASP.NET Core, полностью совместимая с NUnit/xUnit.Net/MSTest. Недавно вышедшая версия 7.1 поддерживает .NET 7, улучшила обработку JSON для конечных точек Minimal API и поддерживает составной тип содержимого форм. Допустим, есть проект Minimal API:

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/", () => "Hello, World!");
app.Run();

Мы можем написать тест маршрута, вроде такого:

[Fact]
public async Task sample_test()
{
  // Здесь для примера хост создаётся внутри теста.
  // В реальности это дорого, 
  // его лучше создать один на все тесты.
  await using var host = 
   await AlbaHost.For<global::Program>();

  var result = await host.GetAsText("/");

  Assert.Equal(result, "Hello, World!");
}

Тест загружает ваше фактическое приложение, используя его конфигурацию, но используя TestServer вместо Kestrel в качестве веб-сервера. Помимо GetAsText() есть другие полезные методы, вроде PostJson(), который использует конфигурацию сериализации JSON вашего приложения, если вдруг она у вас кастомизирована. Аналогично Receive<T>() использует сериализацию JSON вашего приложения. Когда тест выполняется, он проходит через весь конвейер ASP.NET Core вашего приложения, включая любое зарегистрированное промежуточное ПО. Альтернативным вариантом для теста может быть использование класса Scenario и его удобочитаемых методов:

await host.Scenario(_ =>
{
  _.Get.Url("/");
  _.ContentShouldBe("Hello, World!");
  _.StatusCodeShouldBeOk();
});

Библиотека предлагает множество настроек и вариантов использования, которые можно посмотреть в документации. Имейте в виду, чтобы ваши тесты «видели» ваш класс Program, вам нужно разрешить вашему тестовому проекту «видеть» ваш основной проект. Для этого в файл .csproj основного проекта добавьте:

<ItemGroup>
  <InternalsVisibleTo Include="[ИмяПроектаТестов]" />
</ItemGroup>

Источник: https://jeremydmiller.com/2022/11/28/alba-for-effective-asp-net-core-integration-testing/