Microsoft.Testing.Platform の終了コード

Microsoft.Testing.Platform は、既知の終了コードを使用して、テストエラーまたはアプリエラーを伝えます。 終了コードは 0 から始まる非負の数です。 次の表に示すさまざまな終了コードとそれに対応する理由について考えてみましょう。

終了コード	詳細
0	終了コード 0 は成功を表します。 実行するように選択されたすべてのテストは完了まで実行され、エラーはありませんでした。
1	終了コード 1 は不明なエラーを表し、catch all として機能します。 追加のエラー情報と詳細を確認するには、出力を確認します。
2	終了コード 2 は、少なくとも 1 つのテストの失敗が発生したことを表すために使用されます。
3	終了コード 3 は、テスト セッションが中止されたことを表します。 セッションは、たとえば Ctrl+C キーを使用して中止できます。
4	終了コード 4 は、使用されている拡張機能の設定が無効であり、テスト セッションを実行できないことを表します。
5	終了コード 5 は、テスト アプリに渡されたコマンド ライン引数が無効であることを表します。
6	終了コード 6 は、テスト セッションが実装されていない機能を使用していることを表します。
7	終了コード 7 は、テスト セッションが正常に完了できず、クラッシュした可能性があることを表します。 これは、テスト コントローラーの拡張ポイントを介して実行されたテスト セッションによって発生した可能性があります。
8	終了コード 8 は、テスト セッションでテストが 1 つも実行されなかったことを表します。
9	終了コード 9 は、実行されたテストの最小実行数のポリシーに違反があったことを表します。
10	終了コード 10 は、テスト アダプター、Testing.Platform Test Framework、MSTest、NUnit、または xUnit が、テスト自体には関係のないインフラストラクチャの理由でテストを実行できなかったことを表します。 例としては、テストで必要なフィクスチャの作成の失敗があります。
11	終了コード 11 は、依存プロセスが終了した場合にテスト プロセスが終了することを示します。
12	終了コード 12 は、クライアントがサポートされているプロトコル バージョンをサポートしていないため、テスト セッションを実行できなかったことを示します。
13	終了コード 13 は、コマンド ライン オプションを使用して、指定した最大数の失敗したテストに達したため、テスト セッション --maximum-failed-tests 停止したことを示します。 詳細については、「Microsoft.Testing.Platform の概要」の「オプション」セクション を参照してください。

詳細なログ記録を有効にして問題のトラブルシューティングを行うには、 Microsoft.Testing.Platform Diagnostics 拡張機能を参照してください。

特定の終了コードを無視する

Microsoft.Testing.Platform は、既定では厳密に設計されていますが、構成が可能です。 そのため、無視する必要がある終了コードをユーザーが決定できます (元の終了コードではなく、0 の終了コードが返されます)。

特定の終了コードを無視するには、--ignore-exit-code コマンド ライン オプションまたは TESTINGPLATFORM_EXITCODE_IGNORE 環境変数を使用します。 有効な形式は、無視する終了コードのセミコロン区切りのリストです (例: --ignore-exit-code 2;3;8)。 一般的なシナリオは、テストの失敗が 0 以外の終了コード (終了コードの 2の無視に対応する) になってはいけないことを考慮することです。