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 命名空间中的类的实例。

属性

Accessprotected
Sealedtrue

要了解方法的属性，请参阅方法属性。

示例

在插件中使用鉴定

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

提示

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

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

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

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

版本历史记录

在 R2015b 中推出

另请参阅