Microsoft.Testing.Platform
は、既知の終了コードを使用して、テストエラーまたはアプリエラーを伝えます。 終了コードは 0
から始まり、負以外の値になります。 次の表で、さまざまな終了コードとそれに対応する理由について詳しく説明します。
終了コード |
細部 |
0 |
0 終了コードは成功を示します。 実行するように選択されたすべてのテストは完了まで実行され、エラーはありませんでした。 |
1 |
1 終了コードは、不明なエラーを示し、すべての をキャッチとして機能します。 追加のエラー情報と詳細を確認するには、出力を確認します。 |
2 |
2 の終了コードは、少なくとも 1 つのテストエラーが発生したことを示すために使用されます。 |
3 |
終了コード 3 は、テスト セッションが中止されたことを示します。 例として、Ctrl +使用してセッションを中止できます。 |
4 |
終了コード 4 は、使用されている拡張機能のセットアップが無効であり、テスト セッションを実行できないことを示します。 |
5 |
終了コード 5 は、テスト アプリに渡されるコマンド ライン引数が無効であることを示します。 |
6 |
終了コード 6 は、テスト セッションが実装されていない機能を使用していることを示します。 |
7 |
終了コード 7 は、テスト セッションが正常に完了できず、クラッシュした可能性があることを示します。 これは、テスト コントローラーの拡張ポイントを介して実行されたテスト セッションによって発生した可能性があります。 |
8 |
終了コード 8 は、テスト セッションがゼロ テストを実行したことを示します。 |
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
)。 一般的なシナリオは、テストエラーがゼロ以外の終了コード (終了コードの 2
を無視することに対応する) を発生させるべきではないことを考慮することです。