Microsoft.Testing.Platform 退出代码
Microsoft.Testing.Platform
使用已知的退出代码来传达测试失败或应用错误。 退出代码从 0
开始,并且是非负数。 请考虑下表,其中详细说明了各种退出代码及其相应的原因:
退出代码 | 详细信息 |
---|---|
0 |
0 退出代码指示成功。 选择运行的所有测试都运行到完成,并且没有错误。 |
1 |
1 退出代码指示发生未知错误,并充当全部捕获。 若要查找其他错误信息和详细信息,请查看输出。 |
2 |
退出代码 2 用于指示至少已发生一次测试失败。 |
3 |
退出代码 3 指示测试会话已中止。 例如,可以使用 Ctrl+C 中止会话。 |
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 诊断扩展。
忽略特定退出代码
Microsoft.Testing.Platform
默认情况下,设计为严格,但允许配置。 因此,用户可以决定应忽略哪些退出代码(将返回退出代码 0
而不是原始退出代码)。
若要忽略特定的退出代码,请使用 --ignore-exit-code
命令行选项或 TESTINGPLATFORM_EXITCODE_IGNORE
环境变量。 接受的有效格式是要忽略的退出代码的分号分隔列表(例如,--ignore-exit-code 2;3;8
)。 一种常见方案是,测试失败不应导致非零退出代码(这对应于忽略退出代码 2
)。