matlab.unittest.TestResult 类
包: matlab.unittest
运行测试套件的结果
描述
matlab.unittest.TestResult
类用于保存在 matlab.unittest
框架下运行测试套件所得到的结果信息。结果描述信息中包含测试是已通过、失败还是已完成运行,以及每个测试的持续时间。
创建对象
TestResult
数组由测试运行程序创建并返回。TestResult
数组中的对象数量与套件中运行的测试数量相匹配。
属性
Name
— TestSuite
元素的名称
字符向量
与此结果对应的 TestSuite
元素的名称,指定为字符向量。
Passed
— 测试是否通过的指示符
true
| false
测试是否通过的指示符,指定为 true
或 false
。当 Passed
属性为 true
时,则指示测试按预期完成,而没有出现任何失败。当该属性为 false
时,则指示测试未完成运行或遇到了失败条件,或同时出现这两种情况。
Failed
— 测试是否失败的指示符
true
| false
测试是否失败的指示符,指定为 true
或 false
。true
值指示存在某种形式的测试失败。当 Failed
为 false
时,则指示未遇到失败条件。测试中或设置和拆解测试脚手架时的失败条件可导致失败结果。以下原因可能会导致失败:
验证失败
断言失败
未捕获的异常
致命断言也是失败条件,但在致命断言失败的情况下,整个框架将会中止,并且绝不会生成 TestResult
对象。
Incomplete
— 测试是否未运行完毕的指示符
true
| false
测试是否未运行完毕的指示符,指定为 true
或 false
。true
值指示测试未运行完毕。当该属性为 false
时,则指示未遇到阻止测试完成的条件。换句话说,false
指示在正在运行的测试内容外面不存在堆栈中断。测试中或设置和拆解测试脚手架时的堆栈中断可导致未完成的结果。以下原因可能会导致测试未完成运行:
断言失败
测试通过假设进行过滤
未捕获的异常
致命断言也是阻止测试完成的条件,但在致命断言失败的情况下,整个框架将会中止,并且绝不会生成 TestResult
对象。
Duration
— 运行测试所花费的时间
双精度值
运行测试所花费的时间,包括设置和拆解任何测试脚手架的时间,指定为双精度标量。
脚手架的设置时间计入第一个使用脚手架的 TestSuite
元素的持续时间。脚手架的拆解时间计入最后一个使用脚手架的 TestSuite
元素的持续时间。
一套测试的总运行时间会超出套件的所有元素的持续时间之和,因为 Duration
属性不包括 TestRunner
对象的所有开销,也不包括测试运行程序插件占用的任何时间。
Details
— 关于测试的其他信息
结构体
关于测试的其他信息,指定为标量结构体。信息的类型取决于 TestRunner
及其插件的配置。例如,DiagnosticsRecordingPlugin
使用此属性包含它在测试过程中遇到的诊断信息。
方法
公共方法
assertSuccess | 断言测试会话的运行未失败 |
generateDOCXReport | Generate DOCX test report from test results |
generateHTMLReport | Generate HTML test report from test results |
generatePDFReport | Generate PDF test report from test results |
table | 将 TimeResult 数组转换为表 |
版本历史记录
在 R2013a 中推出R2022a: 在测试执行后生成 DOCX、HTML 和 PDF 报告
matlab.unittest.TestResult
类有三个新方法,使您能够根据测试结果生成各种测试报告。您可以运行测试并收集测试结果,然后根据部分或全部结果生成测试报告:
要从测试结果生成 DOCX 报告,请使用
generateDOCXReport
方法。要从测试结果生成 HTML 报告,请使用
generateHTMLReport
方法。要从测试结果生成 PDF 报告,请使用
generatePDFReport
方法。
R2020a: 断言测试会话的运行未失败
matlab.unittest.TestResult
类有新方法 assertSuccess
,它让您可以断言在测试会话期间没有遇到失败的情况。
R2020a: 向 TestResult
对象添加自定义详细信息
在创建自定义插件时,您可以将数据添加到 TestResult
对象的 Details
属性。要向 Details
结构体追加字段,请使用 matlab.unittest.plugins.plugindata.ResultDetails
类的 append
方法。有关详细信息,请参阅编写插件以将数据添加到测试结果。
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)