assertUsing

类: matlab.unittest.plugins.QualifyingPlugin
命名空间: matlab.unittest.plugins

断言值满足给定约束

语法

assertUsing(plugin,context,actual,constraint) assertUsing(plugin,context,actual,constraint,diagnostic)

assertUsing(plugin,context,actual,constraint) 使用鉴定 context 断言 actual 是满足给定约束 constraint 的值。如果实际值不满足该约束，测试框架会报告发生断言失败。

在以下 QualifyingPlugin 方法中，可以执行断言：

assertUsing(plugin,context,actual,constraint,diagnostic) 在失败时显示诊断信息 diagnostic。

插件实例，指定为 matlab.unittest.plugins.QualifyingPlugin 类的实例。

插件的上下文，指定为 matlab.unittest.plugins.plugindata.QualificationContext 类的实例。此实例为插件提供上下文以对测试套件执行鉴定。该插件从插件数据中获取此上下文。

要测试的值，指定为工作区变量。actual 可以是任意数据类型。当 actual 满足指定的约束 constraint 时，鉴定会通过。

测试必须满足的条件，指定为 matlab.unittest.constraints 命名空间中的类的实例。

失败时要显示的诊断信息，指定为字符串、字符向量、函数句柄或 matlab.unittest.diagnostics 命名空间中的类的实例。

请参阅 QualifyingPlugin 类的示例，并将对 verifyUsing 的调用替换为 assertUsing。

如果失败条件导致当前测试内容的剩余部分失效，但不会阻止后续测试方法正确执行，则使用 QualifyingPlugin.assertUsing 方法。断言点处的失败会将相关联的测试内容呈现为失败且未完成。或者，

使用 QualifyingPlugin.verifyUsing 方法可在不引发异常的条件下生成和记录失败。因为 QualifyingPlugin 执行的附加鉴定超出了在单元测试中定义的范围，所以它通常会使用确认。确认不会导致测试提前退出，从而可确保测试框架执行所有测试内容。使用其他鉴定类型来测试是否违反先决条件或测试安装是否正确。
使用 QualifyingPlugin.assumeUsing 方法确保测试环境满足无论如何都不会导致测试失败的先决条件。假设失败会导致测试被滤除，且测试框架会将相关联的测试内容标记为 Incomplete。
使用 QualifyingPlugin.fatalAssertUsing 方法可在失败时中止测试会话。当失败涉及根本以致没必要继续测试时，这种鉴定会很有用。当脚手架拆解未能正确还原 MATLAB^® 状态，适合中止测试并启动一个新会话时，这些鉴定也很有用。