Minimal API アプリでの単体テストと統合テスト

[アーティクル]
11/06/2024

Note

これは、この記事の最新バージョンではありません。現在のリリースについては、この記事の .NET 9 バージョンを参照してください。

警告

このバージョンの ASP.NET Core はサポート対象から除外されました。詳細については、「.NET および .NET Core サポートポリシー」を参照してください。現在のリリースについては、この記事の .NET 8 バージョンを参照してください。

重要

この情報はリリース前の製品に関する事項であり、正式版がリリースされるまでに大幅に変更される可能性があります。 Microsoft はここに示されている情報について、明示か黙示かを問わず、一切保証しません。

現在のリリースについては、この記事の .NET 9 バージョンを参照してください。

作成者: Fiyaz Bin Hasan、Rick Anderson

統合テストの概要

統合テストでは単体テストよりも広範なレベルでアプリのコンポーネントを評価します。単体テストは、個々のクラスメソッドなど、分離されたソフトウェアコンポーネントをテストするために使用されます。統合テストでは、2 つ以上のアプリコンポーネントが、連携して予想される結果を生成することを確認します。これは、要求を完全に処理するために必要なすべてのコンポーネントを含む可能性があります。

これらの広範なテストは、アプリのインフラストラクチャとフレームワーク全体をテストするために使用されます。多くの場合、次のコンポーネントが含まれます。

データベース
ファイルシステム
ネットワークアプライアンス
要求 - 応答パイプライン

単体テストでは、インフラストラクチャコンポーネントの代わりに、フェイクまたはモックオブジェクトと呼ばれる、作成済みのコンポーネントを使用します。

単体テストと比較すると、統合テストは次のようになります。

アプリが運用環境で使用する実際のコンポーネントを使用します。
より多くのコードとデータ処理が必要です。
実行に時間がかかります。

そのため、統合テストの使用は最も重要なインフラストラクチャシナリオに限定します。単体テストと統合テストのどちらを使用しても動作をテストできる場合は、単体テストを選択します。

統合テストの説明では、テスト対象のプロジェクトのことをよく "テスト対象システム"、または短縮して "SUT" と呼びます。この記事全体を通して、テスト対象の ASP.NET Core アプリを指すために "SUT" を使用します。

データベースとファイルシステムを使用するデータおよびファイルアクセスの "すべての順列として統合テストを記述してはいけません"。通常は、アプリ全体でデータベースやファイルシステムを操作する場所がいくつあったとしても、的を絞った一連の読み取り、書き込み、更新、削除の統合テストを行うことで、データベースおよびファイルシステムコンポーネントを適切にテストすることができます。これらのコンポーネントと連携するメソッドのロジックのルーチンテストには、単体テストを使用します。単体テストでは、インフラストラクチャのフェイクまたはモックを使用することにより、テストの実行時間が短縮されます。

ASP.NET Core 統合テスト

ASP.NET Core の統合テストには、次のものが必要です。

テストプロジェクトは、テストを格納して実行するために使用します。テストプロジェクトは SUT への参照を含みます。
テストプロジェクトは、SUT のテスト Web ホストを作成し、テストサーバークライアントを使用して SUT との要求と応答を処理します。
テストランナーは、テストを実行し、テスト結果を報告するために使用されます。

統合テストでは、通常の Arrange (配置) 、Act (実行) 、および Assert (確認) のテストステップを含む一連のイベントに従います。

SUT の Web ホストが構成されます。
アプリに要求を送信するためのテストサーバークライアントが作成されます。
Arrange (配置) テストステップが実行されます。テストアプリが要求を準備します。
Act (実行) テストステップが実行されます。クライアントは要求を送信し、応答を受信します。
Assert (確認) テストステップが実行されます。実際の応答は、予測される応答に基づき、成功または失敗として検証されます。
このプロセスは、すべてのテストが実行されるまで続行されます。
テスト結果が報告されます。

通常、テスト Web ホストは、アプリの通常のテスト用の Web ホストとは異なる方法で構成されています。たとえば、テスト用に別のデータベースまたは異なるアプリ設定を使用する場合があります。

テスト Web ホストやメモリ内テストサーバー (TestServer) などのインフラストラクチャコンポーネントは、Microsoft.AspNetCore.Mvc.Testing パッケージによって提供または管理されます。このパッケージを使用すると、テストの作成と実行を効率化できます。

Microsoft.AspNetCore.Mvc.Testing パッケージは、次のタスクを処理します。

依存関係ファイル ( .deps) を SUT からテストプロジェクトの bin ディレクトリにコピーします。
テストを実行したときに、静的なファイルとページ/ビューが検出されるように、コンテンツルートを SUT のプロジェクトルートに設定します。
WebApplicationFactory クラスを提供し、TestServer を使用して SUT のブートストラップを効率化します。

単体テストのドキュメントでは、テストプロジェクトとテストランナーを設定する方法、テストを実行する方法の詳細な手順、テストおよびテストクラスの命名方法に関する推奨事項について説明します。

単体テストを統合テストから分離し、異なるプロジェクトにします。テストの分離は、次の面で役立ちます。

インフラストラクチャテストコンポーネントが誤って単体テストに含まれないようにすることができる。
実行されるテストのセットを制御することができる。

GitHub のサンプルコードには、Minimal API アプリでの単体テストと統合テストの例が用意されています。

IResult 実装の種類

Microsoft.AspNetCore.Http.HttpResults 名前空間のパブリック IResult 実装の種類を使用すると、ラムダの代わりに名前付きメソッドを使用するときに、最小限のルートハンドラーの単体テストを行うことができます。

次のコードでは、NotFound<TValue> クラスを使用します。

[Fact]
public async Task GetTodoReturnsNotFoundIfNotExists()
{
    // Arrange
    await using var context = new MockDb().CreateDbContext();

    // Act
    var result = await TodoEndpointsV1.GetTodo(1, context);

    //Assert
    Assert.IsType<Results<Ok<Todo>, NotFound>>(result);

    var notFoundResult = (NotFound) result.Result;

    Assert.NotNull(notFoundResult);
}

次のコードでは、Ok<TValue> クラスを使用します。

[Fact]
public async Task GetTodoReturnsTodoFromDatabase()
{
    // Arrange
    await using var context = new MockDb().CreateDbContext();

    context.Todos.Add(new Todo
    {
        Id = 1,
        Title = "Test title",
        Description = "Test description",
        IsDone = false
    });

    await context.SaveChangesAsync();

    // Act
    var result = await TodoEndpointsV1.GetTodo(1, context);

    //Assert
    Assert.IsType<Results<Ok<Todo>, NotFound>>(result);

    var okResult = (Ok<Todo>)result.Result;

    Assert.NotNull(okResult.Value);
    Assert.Equal(1, okResult.Value.Id);
}

その他のリソース

基本認証テストは .NET リポジトリではありませんが、.NET チームのメンバーによって作成されました。基本認証テストの例を示します。
サンプルコードを表示またはダウンロードする
Minimal API での認証と認可
Visual Studio のポートトンネリングを使用して Web API をデバッグする
ASP.NET Core のコントローラーのロジックをテストする
RazorASP.NET Core での Pages の単体テスト

次の方法で共有

Minimal API アプリでの単体テストと統合テスト

統合テストの概要

ASP.NET Core 統合テスト

IResult 実装の種類

その他のリソース

その他のリソース