matlab.unittest.qualifications.FatalAssertable类

包:matlab.unittest.qualifications

中止测试执行的资格

展开全部页面

描述

的FatalAssertable类提供中止测试执行的限定。除了为失败而执行的操作外FatalAssertable类中的其他资格类的工作方式相同matlab.unittest.qualifications包中。

在致命的断言失败时，FatalAssertable类将失败通知测试框架FatalAssertionFailedException对象。然后，框架显示失败的诊断信息并中止测试会话。当故障非常严重，以至于继续测试没有意义时，这种行为是有用的。此外，您可以在fixture拆卸中使用致命断言，以确保正确地恢复环境状态。如果你能把灯具拆下来异常安全的如果要在失败后恢复状态，请改用断言。

致命断言可以防止由于基本测试失败而导致的错误测试失败。当先前的测试无法恢复状态时，它们还可以防止错误的测试失败。如果框架不能正确地拆除fixture，则必须手动重置状态。例如，您可能需要重新启动MATLAB^®．

的matlab.unittest.qualifications.FatalAssertable类是一个处理类。

方法

全部展开

公共方法

的FatalAssertable类提供了用于测试值和响应故障的几种确认方法。例如,fatalAssertEmpty测试值是否为空，以及fatalAssertTrue测试实际值是否为真。

请注意

的方法FatalAssertable类的方法对应可验证的类。他们只在资格类型方面有所不同。你可以致电FatalAssertable方法的调用方法相同可验证的方法。

通用

`fatalAssertEqual`	`fatalAssertEqual (testCase，实际，预期，诊断，名称,值）` 致命地断言`实际`严格地等于`预期`．类似于`verifyEqual`．输入参数 `testCase`—测试用例实例。 `实际`-要测试的值。 `预期`-期望值。 `诊断`—当确认通过或不通过时显示诊断信息。详细信息请参见诊断．名称-值参数 `AbsTol`-绝对公差，指定为数值数组。 `RelTol`-相对公差，指定为数值数组。
`fatalAssertFail`	`fatalAssertFail (testCase，诊断）` 产生无条件致命断言失败。类似于`verifyFail`．输入参数 `testCase`—测试用例实例。 `诊断`—当确认通过或不通过时显示诊断信息。详细信息请参见诊断．
`fatalAssertFalse`	`fatalAssertFalse (testCase，实际，诊断）` 致命的断言的价值`实际`是合乎逻辑的`0`（`假`)．类似于`verifyFalse`．输入参数 `testCase`—测试用例实例。 `实际`-要测试的值。 `诊断`—当确认通过或不通过时显示诊断信息。详细信息请参见诊断．
`fatalAssertNotEqual`	`fatalAssertNotEqual (testCase，实际，禁止，诊断）` 致命地断言`实际`不等于`禁止`．类似于`verifyNotEqual`．输入参数 `testCase`—测试用例实例。 `实际`-要测试的值。 `禁止`-要比较的值。 `诊断`—当确认通过或不通过时显示诊断信息。详细信息请参见诊断．
`fatalAssertNotSameHandle`	`fatalAssertNotSameHandle (testCase，实际，禁止，诊断）` 致命地断言`实际`与禁止的句柄数组不相同。类似于`verifyNotSameHandle`．输入参数 `testCase`—测试用例实例。 `实际`-要测试的值。 `禁止`-要比较的值，指定为句柄数组。 `诊断`—当确认通过或不通过时显示诊断信息。详细信息请参见诊断．
`fatalAssertReturnsTrue`	`fatalAssertReturnsTrue (testCase，实际，诊断）` 致命地断言`实际`函数句柄是否返回逻辑标量`1`（`真正的`)．类似于`verifyReturnsTrue`．输入参数 `testCase`—测试用例实例。 `实际`-要测试的值。 `诊断`—当确认通过或不通过时显示诊断信息。详细信息请参见诊断．
`fatalAssertSameHandle`	`fatalAssertSameHandle (testCase，实际，预期，诊断）` 致命地断言`实际`与预期的句柄数组相同。类似于`verifySameHandle`．输入参数 `testCase`—测试用例实例。 `实际`-要测试的值。 `预期`-期望值，指定为句柄数组。 `诊断`—当确认通过或不通过时显示诊断信息。详细信息请参见诊断．
`fatalAssertThat`	`fatalAssertThat (testCase，实际，约束，诊断）` 致命地断言`实际`满足指定约束的值。类似于`verifyThat`．输入参数 `testCase`—测试用例实例。 `实际`-要测试的值。 `约束`属性的实例指定的实际值必须满足的约束`matlab.unittest.constraints.Constraint`类。 `诊断`—当确认通过或不通过时显示诊断信息。详细信息请参见诊断．
`fatalAssertTrue`	`fatalAssertTrue (testCase，实际，诊断）` 致命的断言的价值`实际`是合乎逻辑的`1`（`真正的`)．类似于`verifyTrue`．输入参数 `testCase`—测试用例实例。 `实际`-要测试的值。 `诊断`—当确认通过或不通过时显示诊断信息。详细信息请参见诊断．

错误和警告

fatalAssertError

［output1,…,outputN= fatalAssertError(testCase，实际，标识符，诊断）

致命地断言实际是函数句柄，该句柄引发标识符．类似于verifyError．

输入参数

testCase—测试用例实例。
实际-要测试的值。
标识符—错误标识符，指定为字符串标量、字符向量或meta.class实例。
诊断—当确认通过或不通过时显示诊断信息。详细信息请参见诊断．

输出参数

output1,…,outputN-输出参数，1到N，请求从实际．

fatalAssertWarning

［output1,…,outputN= fatalAssertWarning(testCase，实际，标识符，诊断）

致命地断言实际是函数句柄，它发出由标识符．类似于verifyWarning．

输入参数

testCase—测试用例实例。
实际-要测试的值。
标识符-警告标识符，指定为字符向量、字符向量的单元格数组或字符串数组。
诊断—当确认通过或不通过时显示诊断信息。详细信息请参见诊断．

输出参数

output1,…,outputN-输出参数，1到N(如果有)，产生时实际被调用。

fatalAssertWarningFree

［output1,…,outputN= fatalAssertWarningFree(testCase，实际，诊断）

致命地断言实际是不发出警告的函数句柄。类似于verifyWarningFree．

输入参数

testCase—测试用例实例。
实际-要测试的值。
诊断—当确认通过或不通过时显示诊断信息。详细信息请参见诊断．

输出参数

output1,…,outputN-输出参数，1到N(如果有)，产生时实际被调用。

不平等

`fatalAssertGreaterThan`	`fatalAssertGreaterThan (testCase，实际，地板上，诊断）` 致命的断言，所有的元素`实际`大于的所有元素`地板上`．类似于`verifyGreaterThan`．输入参数 `testCase`—测试用例实例。 `实际`-要测试的值。 `地板上`-最小值。 `诊断`—当确认通过或不通过时显示诊断信息。详细信息请参见诊断．
`fatalAssertGreaterThanOrEqual`	`fatalAssertGreaterThanOrEqual (testCase，实际，地板上，诊断）` 致命的断言，所有的元素`实际`大于或等于的所有元素`地板上`．类似于`verifyGreaterThanOrEqual`．输入参数 `testCase`—测试用例实例。 `实际`-要测试的值。 `地板上`-最小值。 `诊断`—当确认通过或不通过时显示诊断信息。详细信息请参见诊断．
`fatalAssertLessThan`	`fatalAssertLessThan (testCase，实际，天花板，诊断）` 致命的断言，所有的元素`实际`小于的所有元素`天花板`．类似于`verifyLessThan`．输入参数 `testCase`—测试用例实例。 `实际`-要测试的值。 `天花板`—最大值。 `诊断`—当确认通过或不通过时显示诊断信息。详细信息请参见诊断．
`fatalAssertLessThanOrEqual`	`fatalAssertLessThanOrEqual (testCase，实际，天花板，诊断）` 致命的断言，所有的元素`实际`小于或等于的所有元素`天花板`．类似于`verifyLessThanOrEqual`．输入参数 `testCase`—测试用例实例。 `实际`-要测试的值。 `天花板`—最大值。 `诊断`—当确认通过或不通过时显示诊断信息。详细信息请参见诊断．

数组大小

`fatalAssertEmpty`	`fatalAssertEmpty (testCase，实际，诊断）` 致命地断言`实际`是一个空MATLAB数组。类似于`verifyEmpty`．输入参数 `testCase`—测试用例实例。 `实际`-要测试的值。 `诊断`—当确认通过或不通过时显示诊断信息。详细信息请参见诊断．
`fatalAssertLength`	`fatalAssertLength (testCase，实际，expectedLength，诊断）` 致命地断言`实际`为期望长度的MATLAB数组。类似于`verifyLength`．输入参数 `testCase`—测试用例实例。 `实际`-要测试的值。 `expectedLength`—阵列预期长度。 `诊断`—当确认通过或不通过时显示诊断信息。详细信息请参见诊断．
`fatalAssertNotEmpty`	`fatalAssertNotEmpty (testCase，实际，诊断）` 致命地断言`实际`是一个非空MATLAB数组。类似于`verifyNotEmpty`．输入参数 `testCase`—测试用例实例。 `实际`-要测试的值。 `诊断`—当确认通过或不通过时显示诊断信息。详细信息请参见诊断．
`fatalAssertNumElements`	`fatalAssertNumElements (testCase，实际，expectedNumElements，诊断）` 致命地断言`实际`为期望元素数的MATLAB数组。类似于`verifyNumElements`．输入参数 `testCase`—测试用例实例。 `实际`-要测试的值。 `expectedNumElements`-预期的元素数量。 `诊断`—当确认通过或不通过时显示诊断信息。详细信息请参见诊断．
`fatalAssertSize`	`fatalAssertSize (testCase，实际，expectedSize，诊断）` 致命地断言`实际`为期望大小的MATLAB数组。类似于`verifySize`．输入参数 `testCase`—测试用例实例。 `实际`-要测试的值。 `expectedSize`—预期数组大小。 `诊断`—当确认通过或不通过时显示诊断信息。详细信息请参见诊断．

类型

fatalAssertClass

fatalAssertClass (testCase，实际，类，诊断）

致命的断言类实际指定的类。类似于verifyClass．

输入参数

testCase—测试用例实例。
实际-要测试的值。
类-期望的类，指定为字符串标量、字符向量或meta.class实例。
诊断—当确认通过或不通过时显示诊断信息。详细信息请参见诊断．

fatalAssertInstanceOf

fatalAssertInstanceOf (testCase，实际，类，诊断）

致命地断言实际指定类的实例。类似于verifyInstanceOf．

输入参数

testCase—测试用例实例。
实际-要测试的值。
类-期望的类，指定为字符串标量、字符向量或meta.class实例。
诊断—当确认通过或不通过时显示诊断信息。详细信息请参见诊断．

字符串

fatalAssertMatches

fatalAssertMatches (testCase，实际，表达式，诊断）

致命地断言实际匹配指定正则表达式的字符串标量或字符向量。类似于verifyMatches．

输入参数

testCase—测试用例实例。
实际-要测试的值。
表达式—正则表达式匹配。
诊断—当确认通过或不通过时显示诊断信息。详细信息请参见诊断．

fatalAssertSubstring

fatalAssertSubstring (testCase，实际，子字符串，诊断）

致命地断言实际是包含的字符串标量还是字符向量子字符串．类似于verifySubstring．

输入参数

testCase—测试用例实例。
实际-要测试的值。
子字符串-实际值中包含的文本。
诊断—当确认通过或不通过时显示诊断信息。详细信息请参见诊断．

事件

事件名称触发事件数据事件属性

事件名称	触发	事件数据	事件属性
`FatalAssertionFailed`	致命断言失败时触发。一个`QualificationEventData`对象传递给侦听器回调函数。	`matlab.unittest.qualifications.QualificationEventData`	`NotifyAccess:私人` `ListenAccess:公共`
`FatalAssertionPassed`	在传递致命断言时触发。一个`QualificationEventData`对象传递给侦听器回调函数。	`matlab.unittest.qualifications.QualificationEventData`	`NotifyAccess:私人` `ListenAccess:公共`

FatalAssertionFailed

致命断言失败时触发。一个QualificationEventData对象传递给侦听器回调函数。

matlab.unittest.qualifications.QualificationEventData

NotifyAccess:私人

ListenAccess:公共

FatalAssertionPassed

在传递致命断言时触发。一个QualificationEventData对象传递给侦听器回调函数。

matlab.unittest.qualifications.QualificationEventData

NotifyAccess:私人

ListenAccess:公共

例子

全部折叠

如果状态损坏，终止测试会话

打开实时脚本

测试设置操作系统环境变量值的函数。如果在测试之后不能将环境变量重置为其原始值，则使用致命的断言失败终止测试会话。

在当前文件夹中的某个文件中，创建setUserName函数。函数调用setenv设置“用户名”环境变量。

函数setUserName(名字)setenv (“用户名”、名称)结束

为了测试setUserName函数，创建一个名为SetUserNameTest在当前文件夹中。定义测试所需的类成员:

OriginalUserNameproperty—在测试结束后使用此属性重置环境变量。
testUpdate测试method -存储环境变量的原始值，调用被测函数，验证函数是否将环境变量设置为期望值。因为在测试期间状态会发生变化，所以包含对的调用addTeardown以在测试运行完成后恢复状态。
resetUserNamehelper方法-调用setUserName函数重置环境变量。如果操作不成功，则使用致命断言失败中止测试会话。

classdefSetUserNameTest < matlab.unittest.TestCase属性(SetAccess = private)原始用户名结束方法(测试)函数testUpdate testCase (testCase)。OriginalUserName = getenv(“用户名”）;setUserName (“大卫”testCase.addTeardown(@() testCase.resetUserName) testCase.verifyEqual(“用户名”)，“大卫”）结束结束方法(Access = private)函数resetUserName(testCase . originalusername)“用户名”), testCase.OriginalUserName)结束结束结束

运行SetUserNameTest类。测试通过了。

runtests (“SetUserNameTest”）

运行SetUserNameTest。Done SetUserNameTest __________

ans = TestResult with properties: Name: 'SetUserNameTest/testUpdate' Passed: 1 Failed: 0 Incomplete: 0 Duration: 0.0226详细信息:[1×1 struct]总计:1 Passed, 0 Failed, 0 Incomplete. 0.022649秒测试时间。