テスト レポート

これらの機能では、各セクションで説明されているように、追加の NuGet パッケージをインストールする必要があります。

レポート ファイル名

すべてのレポート拡張機能は、 --results-directory オプションで設定できるテスト結果ディレクトリにファイルを書き込みます。 名前をオーバーライドするには、一致する --report-*-filename オプションを使用します。 各レポート セクションには、そのレポートの既定の名前が一覧表示されます。

ファイル名には、テスト結果ディレクトリ内に留める相対パスを含めることができます。また、次の置換項目 (プレースホルダー) を使用できます。

たとえば、 --report-trx-filename "{asm}_{tfm}_{arch}.trx" は既定の TRX 名を再現します。

レポートの統合

MTP 2.4.0 以降、MTP は、 dotnet test 呼び出しで複数のテスト モジュールが実行された後、または再試行サポートが複数回実行された後に、レポート成果物を自動的に処理します。 この機能は MTP 2.4.0 では試験段階です。

TRX、JUnit、CTRF、および HTML 拡張機能は、レポートの種類別に互換性のある成果物をグループ化し、テスト結果ディレクトリの merged サブディレクトリの下に統合レポートを記述します。 CTRF の統合では、モジュールの結果が結合され、再試行は再試行履歴を含む最終テスト結果に集約されます。 HTML 統合では、マージされた概要が作成され、元のプロセスごとのレポートが保持されます。

カスタム レポート拡張機能の場合、試験的な IArtifactPostProcessor API では、個別の TestModules と RetryAttempts の処理モードが公開されます。 詳細については、「IArtifactPostProcessor拡張機能」を参照してください。

Visual Studio テスト レポート (TRX)

Visual Studioテスト結果ファイル (または TRX) は、テスト結果を発行するための既定の形式です。 この拡張機能には、 Microsoft.Testing.Extensions.TrxReport NuGet パッケージが必要です。

手動登録

var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddTrxReportProvider();

オプション

レポートは、コマンド ライン引数を使用して指定できる既定の --results-directory フォルダー内に保存されます。

HTML レポート

HTML レポートは、テスト セッション用の対話型の自己完結型 HTML ファイルを作成します。 この拡張機能には、Microsoft.Testing.Extensions.HtmlReport NuGet パッケージが必要です。

手動登録

var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddHtmlReportProvider();

オプション

JUnit レポート

JUnit レポートは、テスト セッション用の JUnit 互換 XML ファイルを作成します。 この拡張機能には、Microsoft.Testing.Extensions.JUnitReport NuGet パッケージが必要です。

手動登録

var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddJUnitReportProvider();

オプション

CTRF レポート

CTRF レポートは、テスト セッションに 共通テスト レポート形式 を使用する JSON ファイルを作成します。 この拡張機能には Microsoft.Testing.Extensions.CtrfReport NuGet パッケージが必要です。

手動登録

var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddCtrfReportProvider();

オプション

MSTest 4.4 以降、再試行されたテストの CTRF 結果には、 retries フィールドと retryAttempts フィールドが含まれます。 以前の試行が失敗した後にテストに合格した場合、その結果には flaky: trueも含まれます。 ターミナルの概要では、不安定なテストと再試行されたテストが識別されます。 TRX レポートと JUnit レポートでは、すべての試行を記録するのではなく、テストごとに 1 つの最終結果が保持されます。

Azure DevOps レポート

Azure DevOps レポート プラグインは、GitHubでコードをホストし、Azure DevOpsのビルド エージェントでビルドを行う開発者のために、テストの実行を強化します。 エラーに追加情報が追加され、GitHub PR でエラーが直接表示されます。

この拡張機能には、 Microsoft.Testing.Extensions.AzureDevOpsReport NuGet パッケージが必要です。

手動登録

var builder = await TestApplication.CreateBuilderAsync(args);
builder.TestHost.AddAzureDevOpsProvider();

オプション

拡張機能は、 TF_BUILD 環境変数を確認することで、継続的インテグレーション (CI) 環境で実行されていることを自動的に検出します。

MTP 2.4.0 以降、Azure DevOps Markdown では、dotnet test呼び出しのすべてのテスト モジュール全体の結果が集計されます。 また、コード カバレッジを有効にすると、対象データと合計カウント、パーセンテージ、しきい値の結果、カバレッジ データが部分的な場合のインジケーターが概要に含まれます。

GitHub Actions レポート

GitHub Actions レポートは GitHub Actions ネイティブのワークフロー コマンドを出力するため、テスト実行時にランナー上で優れたエクスペリエンスを実現します。これには、アセンブリごとのログ グループ、失敗およびスキップされたテストの注釈（ワークフローの Annotations タブに表示され、ソースの場所を解決できる場合はプル リクエストの Files changed 差分にも表示）、GITHUB_STEP_SUMMARY が参照するファイルに追記される Markdown のジョブ サマリー、および低速なテストの通知が含まれます。

この拡張機能には Microsoft.Testing.Extensions.GitHubActionsReport NuGet パッケージが必要です。

拡張機能は、実行がGitHub Actions (GITHUB_ACTIONS環境変数がtrue) にあり、--report-gh スイッチが設定されている場合にのみアクティブになります。それ以外の場合は何も実行されません。 アクティブな場合、各機能は既定で有効になり、 --report-gh-* オプションを使用して個別にオフにすることができます。

手動登録

var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddGitHubActionsProvider();

オプション

MTP 2.4.0 以降、GitHub Actions Markdown では、dotnet test呼び出し内のすべてのテスト モジュール全体の集計結果が集計されます。 また、コード カバレッジを有効にする場合は、 coverage または all を選択して、対象となるカウントと合計カウント、パーセンテージ、しきい値の結果、カバレッジ データが部分的な場合のインジケーターを含めます。