Main Content

matlab.unittest.TestResult 类

命名空间: matlab.unittest

运行测试套件的结果

描述

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

创建对象

TestResult 数组由测试运行器创建并返回。TestResult 数组中的对象数量与套件中运行的测试数量相匹配。

属性

全部展开

与此结果对应的 TestSuite 元素的名称,指定为字符向量。

测试是否通过的指示符,指定为 truefalse。当 Passed 属性为 true 时,则指示测试按预期完成,而没有出现任何失败。当该属性为 false 时,则指示测试未完成运行或遇到了失败条件,或同时出现这两种情况。

测试是否失败的指示符,指定为 truefalsetrue 值指示存在某种形式的测试失败。当 Failedfalse 时,则指示未遇到失败条件。测试中或设置和拆解测试脚手架时的失败条件可导致失败结果。以下原因可能会导致失败:

  • 验证失败

  • 断言失败

  • 未捕获的异常

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

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

  • 断言失败

  • 测试通过假设进行过滤

  • 未捕获的异常

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

运行测试所花费的时间,包括设置和拆解任何测试脚手架的时间,指定为双精度标量。

脚手架的设置时间计入第一个使用脚手架的 TestSuite 元素的持续时间。脚手架的拆解时间计入最后一个使用脚手架的 TestSuite 元素的持续时间。

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

关于测试的其他信息,指定为标量结构体。信息的类型取决于 TestRunner 及其插件的配置。例如,DiagnosticsRecordingPlugin 使用此属性包含它在测试过程中遇到的诊断信息。

方法

全部展开

版本历史记录

在 R2013a 中推出

全部展开