Main Content

assumeUsing

类: matlab.unittest.plugins.QualifyingPlugin
包: matlab.unittest.plugins

假设值满足给定约束

语法

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

说明

assumeUsing(plugin,context,actual,constraint) 使用验证 context 假设 actual 是满足给定约束 constraint 的值。如果实际值不满足该约束,测试框架会报告发生假设失败。

在以下 QualifyingPlugin 方法中,可以执行假设:

  • setupSharedTestFixture

  • teardownSharedTestFixture

  • setupTestClass

  • teardownTestClass

  • setupTestMethod

  • teardownTestMethod

assumeUsing(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 的调用替换为 assumeUsing

提示

使用 QualifyingPlugin.assumeUsing 方法确保测试环境满足无论如何都不会导致测试失败的先决条件。假设失败会导致测试被滤除,且测试框架会将相关联的测试内容标记为 Incomplete。或者,

  • 使用 QualifyingPlugin.verifyUsing 方法可在不引发异常的条件下生成和记录失败。因为 QualifyingPlugin 执行的附加验证超出了在单元测试中定义的范围,所以它通常会使用确认。确认不会导致测试提前退出,从而可确保测试框架执行所有测试内容。使用其他验证类型来测试是否违反先决条件或测试安装是否正确。

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

  • 使用 QualifyingPlugin.fatalAssertUsing 方法可在失败时中止测试会话。当失败涉及根本以致没必要继续测试时,这种验证会很有用。当脚手架拆解未能正确还原 MATLAB® 状态,适合中止测试并启动一个新会话时,这些验证也很有用。

版本历史记录

在 R2015b 中推出