log

类: matlab.unittest.TestCase
命名空间: matlab.unittest

在测试执行期间记录诊断信息

语法

log(testCase,diagnostic) log(testCase,v,diagnostic)

说明

log(testCase,diagnostic) 记录提供的诊断信息。日志方法提供一种测试手段，用于在测试执行期间记录信息。测试框架仅在经过适当配置（添加相应的插件，例如 matlab.unittest.plugins.LoggingPlugin）后，才会显示记录的消息。

log(testCase,v,diagnostic) 按指定的详细级别 v 记录诊断信息。

输入参数

全部展开

`testCase` — 测试用例的实例
`matlab.unittest.TestCase` 实例

测试用例的实例，指定为 matlab.unittest.TestCase。

`diagnostic` — 失败时显示的诊断信息
字符数组 | 字符串数组 | 函数句柄 | `matlab.automation.diagnostics.Diagnostic` 实例

失败时显示的诊断信息，指定为字符串数组、字符数组、函数句柄或 matlab.automation.diagnostics.Diagnostic 实例。

`v` — 详细级别
`2` (默认) | `1` | `3` | `4` | `matlab.automation.Verbosity` 枚举 | 枚举名称作为字符串或字符向量

详细级别，指定为介于 1 和 4 之间的整数值、matlab.automation.Verbosity 枚举对象，或对应于预定义枚举成员名称之一的字符串标量或字符向量。诊断消息的默认详细级别是 Concise。整数值对应于 matlab.automation.Verbosity 枚举的成员。

数值表示	枚举成员名称	详细程度描述
`1`	`Terse`	最少的信息
`2`	`Concise`	适中信息量
`3`	`Detailed`	部分补充信息
`4`	`Verbose`	大量补充信息

示例

全部展开

日志诊断信息

在工作文件夹下的文件 sampleLogTest.m 中，创建一个基于函数的测试。

function tests = sampleLogTest
tests = functiontests(localfunctions);

function svdTest(testCase)
import matlab.automation.Verbosity

log(testCase,'Generating matrix.')
m = rand(1000);

log(testCase,1,'About to call SVD.')
[U,S,V] = svd(m);

log(testCase,Verbosity.Terse,'SVD finished.')

verifyEqual(testCase,U*S*V',m,'AbsTol',1e-6)

在命令提示符下运行测试。

results = run(sampleLogTest);

Running sampleLogTest

[Terse] Diagnostic logged (2022-10-15 18:35:02): About to call SVD.

[Terse] Diagnostic logged (2022-10-15 18:35:20): SVD finished.
.
Done sampleLogTest
__________

默认运行器报告第 1 级别的诊断 (Terse)。

创建一个用于报告级别 1 和级别 2 的诊断的测试运行器，并重新运行该测试。

import matlab.unittest.TestRunner
import matlab.unittest.plugins.LoggingPlugin

runner = TestRunner.withNoPlugins;
p = LoggingPlugin.withVerbosity(2);
runner.addPlugin(p)

results = runner.run(sampleLogTest);

 [Concise] Diagnostic logged (2022-10-15T18:36:05): Generating matrix.
   [Terse] Diagnostic logged (2022-10-15T18:36:05): About to call SVD.
   [Terse] Diagnostic logged (2022-10-15T18:36:05): SVD finished.