本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

matlab.unittest.TestResult 类

包: matlab.unittest

运行测试套件的结果

说明

matlab.unittest.TestResult 类用于保存在 matlab.unittest 框架下运行测试套件所得到的结果信息。结果描述信息中包含测试是已通过、失败还是已完成运行,以及每个测试的持续时间。

构造

TestResult 数组由测试运行程序创建并返回,其大小与所运行的测试套件的大小相同。

属性

Name

结果中 TestSuite 对象的名称。

Name 属性是一个字符向量,用于保存与此结果对应的测试的名称。

Passed

指明测试是否已通过的逻辑值。

Passed 属性为 TRUE 时,则指示测试按预期完成,而没有出现任何失败。当该属性为 FALSE 时,则指示测试未完成运行和/或遇到了失败条件。

Failed

指明测试是否已失败的逻辑值。

Failed 属性为 TRUE 指示存在某种形式的测试失败。当 Failed 为 FALSE 时,则指示未遇到失败条件。测试中或设置和拆解测试脚手架时的失败条件可导致失败结果。以下原因可能会导致失败:

  • 验证失败

  • 断言失败

  • 未捕获的 MException

致命断言也是失败条件,但在致命断言失败的情况下,整个框架将会中止,并且绝不会生成 TestResult 对象。

Incomplete

指明测试是否未完成运行的逻辑值。

Incomplete 属性为 TRUE 指示测试未完成运行。当该属性为 FALSE 时,则指示未遇到阻止测试完成的条件。换句话说,当该属性为 FALSE 时,在正在运行的测试内容外面不存在堆栈中断。测试中或设置和拆解测试脚手架时的堆栈中断可导致未完成的结果。以下原因可能会导致测试未完成运行:

  • 断言失败

  • 测试通过假设进行筛选

  • 未捕获的 MException

致命断言也是阻止测试完成的条件,但在致命断言失败的情况下,整个框架将会中止,并且绝不会生成 TestResult 对象。

Duration

运行测试所用时间。

Duration 属性指示运行特定测试所花费的时间量,包括设置和拆解任何测试脚手架花费的时间。

脚手架的设置时间计入第一个使用脚手架的测试套件数组元素的持续时间。脚手架的拆解时间计入最后一个使用脚手架的测试套件数组元素的持续时间。

一套测试的总运行时间会超出套件的所有元素的持续时间之和,因为 Duration 属性不包括 TestRunner 对象的所有开销,也不包括测试运行程序插件占用的任何时间。

Details

测试结果数据。

Details 属性包含与测试执行相关的其他信息。信息的类型取决于 TestRunner 及其插件的配置。例如,DiagnosticsRecordingPlugin 使用此属性包含它在测试过程中遇到的诊断信息。

提示

  • 根据 TestResult 对象创建表,以便访问 table 功能,例如对行排序、显示摘要以及将表写入文件。例如,

    rt = table(results);