matlab.unittest.qualifications.FatalAssertable class

Пакет: matlab.unittest.qualifications

Проверка, чтобы прервать выполнение теста

Описание

FatalAssertable класс обеспечивает проверку, чтобы прервать выполнение теста. Кроме действий, выполняемых для отказов, FatalAssertable класс работает то же самое другими классами проверки в matlab.unittest.qualifications пакет.

После отказа критического утверждения, FatalAssertable класс сообщает среде тестирования об отказе путем броска FatalAssertionFailedException объект. Среда затем отображает диагностическую информацию для отказа и прерывает сеанс тестирования. Это поведение полезно, когда отказ является так основным, что продолжение тестирования не целесообразно. Кроме того, можно использовать критические утверждения в отключении фиксатора, чтобы гарантировать, что состояние среды восстанавливается правильно. Если можно сделать исключение отключения фиксатора безопасным и восстановить состояние после отказа, используйте утверждения вместо этого.

Критические утверждения предотвращают ложные непройденные тесты из-за отказа основного теста. Они также предотвращают ложные непройденные тесты, когда предшествующему тесту не удается восстановить состояние. Если среда не может правильно разъединить фиксаторы, необходимо вручную сбросить состояние. Например, вы можете должны быть перезапустить MATLAB^®.

matlab.unittest.qualifications.FatalAssertable классом является handle класс.

Методы

развернуть все

Открытые методы

FatalAssertable класс предоставляет несколько методов проверки для тестирования значений и ответа на отказы. Например, fatalAssertEmpty тесты, что значение пусто, и fatalAssertTrue тесты, что фактическое значение верно.

Примечание

Методы FatalAssertable класс соответствует методам Verifiable класс. Они отличаются только в терминах типа проверки. Можно вызвать FatalAssertable методы таким же образом вы вызываете Verifiable методы.

Общая цель

`fatalAssertEqual`	`fatalAssertEqual(testCase,actual,expected,diagnostic,Name,Value)` Фатально утверждайте тот `actual` строго равно `expected`. Подобно `verifyEqual`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `expected` — Ожидаемое значение. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику. Аргументы name-value `AbsTol` — Абсолютная погрешность в виде числового массива. `RelTol` — Относительная погрешность в виде числового массива.
`fatalAssertFail`	`fatalAssertFail(testCase,diagnostic)` Произведите безусловный отказ критического утверждения. Подобно `verifyFail`. Входные параметры `testCase` Экземпляр TestCase. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`fatalAssertFalse`	`fatalAssertFalse(testCase,actual,diagnostic)` Фатально утверждайте что значение `actual` логический `0` `ложь`). Подобно `verifyFalse`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`fatalAssertNotEqual`	`fatalAssertNotEqual(testCase,actual,prohibited,diagnostic)` Фатально утверждайте тот `actual` не равно `prohibited`. Подобно `verifyNotEqual`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `prohibited` — Значение, чтобы выдержать сравнение с. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`fatalAssertNotSameHandle`	`fatalAssertNotSameHandle(testCase,actual,prohibited,diagnostic)` Фатально утверждайте тот `actual` различный как запрещенный массив указателя. Подобно `verifyNotSameHandle`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `prohibited` — Значение, чтобы выдержать сравнение с в виде массива указателя. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`fatalAssertReturnsTrue`	`fatalAssertReturnsTrue(testCase,actual,diagnostic)` Фатально утверждайте тот `actual` указатель на функцию, который возвращает логический скалярный `1` `TRUE`). Подобно `verifyReturnsTrue`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`fatalAssertSameHandle`	`fatalAssertSameHandle(testCase,actual,expected,diagnostic)` Фатально утверждайте тот `actual` совпадает с ожидаемым массивом указателя. Подобно `verifySameHandle`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `expected` — Ожидаемое значение в виде массива указателя. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`fatalAssertThat`	`fatalAssertThat(testCase,actual,constraint,diagnostic)` Фатально утверждайте тот `actual` значение, которое удовлетворяет заданному ограничению. Подобно `verifyThat`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `constraint` — Ограничение, которому фактическое значение должно удовлетворить в виде экземпляра `matlab.unittest.constraints.Constraint` класс. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`fatalAssertTrue`	`fatalAssertTrue(testCase,actual,diagnostic)` Фатально утверждайте что значение `actual` логический `1` `TRUE`). Подобно `verifyTrue`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.

Ошибки и предупреждения

fatalAssertError

[output1,...,outputN] = fatalAssertError(testCase,actual,identifier,diagnostic)

Фатально утверждайте тот actual указатель на функцию, который выдает исключение, заданное identifier. Подобно verifyError.

Входные параметры

testCase Экземпляр TestCase.
actual — Значение для проверки.
identifier — Ошибочный идентификатор в виде строкового скаляра, вектора символов или meta.class экземпляр.
diagnostic — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.

Выходные аргументы

output1,...,outputN — Выходные аргументы, 1 через N, который требуют от actual.

fatalAssertWarning

[output1,...,outputN] = fatalAssertWarning(testCase,actual,identifier,diagnostic)

Фатально утверждайте тот actual указатель на функцию, который выдает предупреждение, заданное identifier. Подобно verifyWarning.

Входные параметры

testCase Экземпляр TestCase.
actual — Значение для проверки.
identifier — Предупреждая идентификатор в виде вектора символов, массива ячеек из символьных векторов или массива строк.
diagnostic — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.

Выходные аргументы

output1,...,outputN — Выходные аргументы, 1 через N (если таковые имеются), произведенный, когда actual вызывается.

fatalAssertWarningFree

[output1,...,outputN] = fatalAssertWarningFree(testCase,actual,diagnostic)

Фатально утверждайте тот actual указатель на функцию, который не выдает предупреждений. Подобно verifyWarningFree.

Входные параметры

testCase Экземпляр TestCase.
actual — Значение для проверки.
diagnostic — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.

Выходные аргументы

output1,...,outputN — Выходные аргументы, 1 через N (если таковые имеются), произведенный, когда actual вызывается.

Неравенства

`fatalAssertGreaterThan`	`fatalAssertGreaterThan(testCase,actual,floor,diagnostic)` Фатально утверждайте что все элементы `actual` больше всех элементов `floor`. Подобно `verifyGreaterThan`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `floor` — Минимальное значение. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`fatalAssertGreaterThanOrEqual`	`fatalAssertGreaterThanOrEqual(testCase,actual,floor,diagnostic)` Фатально утверждайте что все элементы `actual` больше или равны всем элементам `floor`. Подобно `verifyGreaterThanOrEqual`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `floor` — Минимальное значение. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`fatalAssertLessThan`	`fatalAssertLessThan(testCase,actual,ceiling,diagnostic)` Фатально утверждайте что все элементы `actual` меньше всех элементов `ceiling`. Подобно `verifyLessThan`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `ceiling` — Максимальное значение. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`fatalAssertLessThanOrEqual`	`fatalAssertLessThanOrEqual(testCase,actual,ceiling,diagnostic)` Фатально утверждайте что все элементы `actual` меньше чем или равны всем элементам `ceiling`. Подобно `verifyLessThanOrEqual`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `ceiling` — Максимальное значение. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.

Размер массивов

`fatalAssertEmpty`	`fatalAssertEmpty(testCase,actual,diagnostic)` Фатально утверждайте тот `actual` пустой массив MATLAB. Подобно `verifyEmpty`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`fatalAssertLength`	`fatalAssertLength(testCase,actual,expectedLength,diagnostic)` Фатально утверждайте тот `actual` массив MATLAB с ожидаемой длиной. Подобно `verifyLength`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `expectedLength` — Ожидаемая длина массива. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`fatalAssertNotEmpty`	`fatalAssertNotEmpty(testCase,actual,diagnostic)` Фатально утверждайте тот `actual` непустой массив MATLAB. Подобно `verifyNotEmpty`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`fatalAssertNumElements`	`fatalAssertNumElements(testCase,actual,expectedNumElements,diagnostic)` Фатально утверждайте тот `actual` массив MATLAB с ожидаемым числом элементов. Подобно `verifyNumElements`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `expectedNumElements` — Ожидаемое число элементов. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`fatalAssertSize`	`fatalAssertSize(testCase,actual,expectedSize,diagnostic)` Фатально утверждайте тот `actual` массив MATLAB с ожидаемым размером. Подобно `verifySize`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `expectedSize` — Ожидаемый размер массивов. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.

Ввод

fatalAssertClass

fatalAssertClass(testCase,actual,class,diagnostic)

Фатально утверждайте что класс actual заданный класс. Подобно verifyClass.

Входные параметры

testCase Экземпляр TestCase.
actual — Значение для проверки.
class — Ожидаемый класс в виде строкового скаляра, вектора символов или meta.class экземпляр.
diagnostic — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.

fatalAssertInstanceOf

fatalAssertInstanceOf(testCase,actual,class,diagnostic)

Фатально утверждайте тот actual экземпляр заданного класса. Подобно verifyInstanceOf.

Входные параметры

testCase Экземпляр TestCase.
actual — Значение для проверки.
class — Ожидаемый класс в виде строкового скаляра, вектора символов или meta.class экземпляр.
diagnostic — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.

Строки

fatalAssertMatches

fatalAssertMatches(testCase,actual,expression,diagnostic)

Фатально утверждайте тот actual строковый скаляр или вектор символов, который совпадает с заданным регулярным выражением. Подобно verifyMatches.

Входные параметры

testCase Экземпляр TestCase.
actual — Значение для проверки.
expression — Регулярное выражение, чтобы соответствовать.
diagnostic — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.

fatalAssertSubstring

fatalAssertSubstring(testCase,actual,substring,diagnostic)

Фатально утверждайте тот actual строковый скаляр или вектор символов, который содержит substring. Подобно verifySubstring.

Входные параметры

testCase Экземпляр TestCase.
actual — Значение для проверки.
substring — Текст содержится в фактическом значении.
diagnostic — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.

События

EventName Триггер Данные о событиях Атрибуты события

EventName	Триггер	Данные о событиях	Атрибуты события
`FatalAssertionFailed`	Инициированный после сбоя критического утверждения. `QualificationEventData` объект передается функциям обратного вызова прослушивателя.	`matlab.unittest.qualifications.QualificationEventData`	`NotifyAccess: private` `ListenAccess: public`
`FatalAssertionPassed`	Инициированный после передачи критического утверждения. `QualificationEventData` объект передается функциям обратного вызова прослушивателя.	`matlab.unittest.qualifications.QualificationEventData`	`NotifyAccess: private` `ListenAccess: public`

FatalAssertionFailed

Инициированный после сбоя критического утверждения. QualificationEventData объект передается функциям обратного вызова прослушивателя.

matlab.unittest.qualifications.QualificationEventData

NotifyAccess: private

ListenAccess: public

FatalAssertionPassed

Инициированный после передачи критического утверждения. QualificationEventData объект передается функциям обратного вызова прослушивателя.

matlab.unittest.qualifications.QualificationEventData

NotifyAccess: private

ListenAccess: public

Примеры

свернуть все

Прервите Сеанс тестирования, если состояние Повреждается

Скрипт Open Live Script

Протестируйте функцию, которая устанавливает значение переменной среды операционных систем. Если переменная окружения не может быть сброшена к ее исходному значению после теста, прервать сеанс тестирования с помощью отказа критического утверждения.

В файле в вашей текущей папке создайте setUserName функция. Функция использует вызов setenv установить 'UserName' переменная окружения.

function setUserName(name)
setenv('UserName',name)
end

Протестировать setUserName функционируйте, создайте тестовый класс под названием SetUserNameTest в вашей текущей папке. Задайте необходимые члены класса для своего теста:

OriginalUserName свойство — Использование это свойство сбросить переменную окружения после теста.
testUpdate Test метод — Хранилище исходное значение переменной окружения, вызовите функцию под тестом и проверьте, что функция устанавливает переменную окружения на ожидаемое значение. Поскольку изменения состояния во время теста, включайте вызов addTeardown восстановить состояние однажды тестовые прогоны к завершению.
resetUserName вспомогательный метод — Вызов setUserName функционируйте, чтобы сбросить переменную окружения. Если операция не успешна, прервите сеанс тестирования с помощью отказа критического утверждения.

classdef SetUserNameTest < matlab.unittest.TestCase
    properties (SetAccess = private)
        OriginalUserName
    end
    
    methods (Test)
        function testUpdate(testCase)
            testCase.OriginalUserName = getenv('UserName');
            setUserName('David')
            testCase.addTeardown(@() testCase.resetUserName)
            testCase.verifyEqual(getenv('UserName'),'David')
        end
    end

    methods (Access = private)
        function resetUserName(testCase)
            setUserName(testCase.OriginalUserName)
            testCase.fatalAssertEqual(getenv('UserName'),testCase.OriginalUserName)
        end
    end
end

Запустите SetUserNameTest класс. Тестовые передачи.

runtests("SetUserNameTest")

Running SetUserNameTest
.
Done SetUserNameTest
__________

ans = 
  TestResult with properties:

          Name: 'SetUserNameTest/testUpdate'
        Passed: 1
        Failed: 0
    Incomplete: 0
      Duration: 0.0226
       Details: [1×1 struct]

Totals:
   1 Passed, 0 Failed, 0 Incomplete.
   0.022649 seconds testing time.

Больше о

развернуть все

Диагностика

В зависимости от настройки исполнителя тестов среда тестирования может отобразить диагностику, когда проверка передает или перестала работать. По умолчанию среда отображает диагностику только, когда проверка перестала работать. Можно заменить поведение по умолчанию путем настройки исполнителя тестов. Например, можно использовать DiagnosticsOutputPlugin экземпляр, чтобы отобразить и провальную и передающую диагностику события.

Чтобы добавить диагностическое сообщение в тест, используйте дополнительный diagnostic аргумент в любом из методов проверки. Можно задать diagnostic как массив строк, символьный массив, указатель на функцию или массив matlab.unittest.diagnostics.Diagnostic объекты.

Устойчивость к исключениям

Содержанием теста является exception safe, когда все отключение фиксатора выполняется с addTeardown метод TestCase или Fixture классы, или когда это выполняется с помощью объектных деструкторов после отказа. Безопасность исключения гарантирует, что непройденный тест не влияет на последующие тесты, даже когда исключение выдается.

Например, этот код не является безопасным исключением. Если тест перестал работать, среда тестирования не закрывает фигуру.

% Not exception safe
f = figure;
testCase.fatalAssertEqual(actual,expected)
close(f)

С другой стороны, этот код является безопасным исключением, потому что среда закрывает фигуру независимо от тестового результата.

% Exception safe
f = figure;
testCase.addTeardown(@close,f)
testCase.fatalAssertEqual(actual,expected)

Разъединение фиксатора с помощью addTeardown не гарантирует, что код является безопасным исключением. Этот код не является безопасным исключением, потому что вызов addTeardown помещается после теста. Если тест перестал работать, среда не может закрыть фигуру.

% Not exception safe
f = figure;
testCase.fatalAssertEqual(actual,expected)
testCase.addTeardown(@close,f)

Темы

Таблица верификаций, утверждений и других проверок

Введенный в R2013a

Документация

matlab.unittest.qualifications.FatalAssertable class

Описание

Методы

Открытые методы

События

Примеры

Прервите Сеанс тестирования, если состояние Повреждается

Больше о

Диагностика

Устойчивость к исключениям

Смотрите также

Темы

Документация MATLAB

Поддержка