Microsoft.Testing.Platform 結束代碼
Microsoft.Testing.Platform
會使用已知的結束代碼來傳達測試失敗或應用程式錯誤。 結束代碼從 0
開始且為非負數。 請考慮下表,詳細說明各種結束代碼及其對應的原因:
結束代碼 | 詳細資料 |
---|---|
0 |
0 結束代碼表示成功。 選擇執行的所有測試都會執行到完成,而且沒有任何錯誤。 |
1 |
1 結束代碼表示未知的錯誤,且作用如同 catch all。 若要尋找其他錯誤資訊和詳細數據,請查看輸出。 |
2 |
2 的結束代碼用於指出至少有一個測試失敗。 |
3 |
結束代碼 3 表示測試工作階段已中止。 舉例來說,使用 Ctrl+C 可以中止工作階段。 |
4 |
結束代碼 4 表示已使用延伸模組的設定無效,且無法執行測試延伸模組。 |
5 |
結束代碼 5 表示傳遞給測試應用程式的命令列引數無效。 |
6 |
結束代碼 6 指出測試工作階段使用非實作的功能。 |
7 |
結束代碼 7 表示測試工作階段無法順利完成,而且可能損毀。 可能是由透過測試控制器擴充點執行的測試會話所造成。 |
8 |
結束代碼 8 表示測試工作階段執行了零個測試。 |
9 |
結束代碼 9 表示已違反所執行測試的最低執行原則。 |
10 |
結束代碼 10 指出測試配接器 Test.Platform Test Framework、MSTest、NUnit 或 xUnit 無法執行測試,因為與測試本身無關的基礎結構原因。 範例無法建立測試所需的固件。 |
11 |
結束代碼 11 表示如果相依進程結束時,測試程式將會結束。 |
12 |
結束代碼 12 表示測試會話無法執行,因為用戶端不支援任何支援的通訊協定版本。 |
13 |
結束代碼 13 指出測試會話已停止,因為使用 --maximum-failed-tests 命令行選項達到指定的失敗測試數目上限。 如需詳細資訊,請參閱 Microsoft.Testing.Platform 概觀中的選項一節 |
若要啟用詳細資訊記錄並針對問題進行疑難解答,請參閱 Microsoft.Testing.Platform 診斷延伸模組。
忽略特定結束代碼
Microsoft.Testing.Platform
設計為預設為嚴格,但允許設定。 因此,使用者可以決定應忽略哪些結束代碼 (將傳回 0
的結束代碼,而不是原始結束代碼)。
若要忽略特定結束代碼,請使用 --ignore-exit-code
命令列選項或 TESTINGPLATFORM_EXITCODE_IGNORE
環境變數。 接受的有效格式是要忽略的結束代碼清單 (以分號分隔) (例如,--ignore-exit-code 2;3;8
)。 常見的案例是,測試失敗不應該導致非零結束代碼(這對應於忽略結束代碼 2
)。