verifyError

Класс: matlab.unittest.qualifications. Проверяемый
Пакет: matlab.unittest.qualifications

Проверьте, что функция выдает указанное исключение

Синтаксис

verifyError(verifiable,actual,identifier) verifyError(verifiable,actual,metaClass) verifyError(___,diagnostic) [output1,...,outputN] = verifyError(___)

Описание

verifyError(verifiable,actual,identifier) проверяет, что actual - указатель на функцию, выдающий исключение с идентификатором ошибки, равным identifier.

verifyError(verifiable,actual,metaClass) проверяет, что actual - указатель на функцию, выдающий исключение, тип которого определяется meta.class образец, заданный в metaClass. Этот метод не требует, чтобы образец был точным соответствием классов, но скорее он должен быть в заданной иерархии классов, и эта иерархия должна включать в себя MException класс.

verifyError(___,diagnostic) также связывает диагностическую информацию в diagnostic с проверкой. В зависимости от конфигурации исполнителя тестов строение тестирования может отображать диагностику, когда проверка проходит или не проходит. По умолчанию среда отображает диагностику только в случае сбоя проверки. Поведение по умолчанию можно переопределить путем настройки исполнителя тестов. Для примера используйте DiagnosticsOutputPlugin образец для отображения как сбойной, так и проходящей диагностики событий.

[output1,...,outputN] = verifyError(___) возвращает несколько выходных аргументов из вызова указателя на функцию actual. Используйте этот синтаксис, чтобы контролировать количество выходных аргументов, запрашиваемых из указателя на функцию. Если функции обрабатывают ошибки, все выходы имеют тип missing. В противном случае output1,...,outputN являются выходными значениями из actual. Можно использовать этот синтаксис с любым из входных параметров предыдущих синтаксисов.

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

`verifiable`	The `matlab.unittest.TestCase` образец, который используется для прохождения или непрохождения верификации в сочетании с тестовой средой.
`actual`	Значение для тестирования.
`identifier`	Идентификатор ошибки, заданный как вектор символов.
`metaClass`	Образец `meta.class`.
`diagnostic`	Диагностическая информация, относящаяся к проверке, указывается как одно из следующего: Строковые массивы Символьный массив указатель на функцию `matlab.unittest.diagnostics.Diagnostic` объект Значения диагностики могут быть нескалярными. Для получения дополнительной информации смотрите `matlab.unittest.diagnostics.Diagnostic`.

Примеры

расширить все

Тест на идентификаторы ошибок

testCase = matlab.unittest.TestCase.forInteractiveUse;

% Passing scenarios
%%%%%%%%%%%%%%%%%%%%
verifyError(testCase, @() error('SOME:error:id','Error!'), 'SOME:error:id');
verifyError(testCase, @testCase.assertFail, ...
    ?matlab.unittest.qualifications.AssertionFailedException);
 
% Failing scenarios
%%%%%%%%%%%%%%%%%%%%
verifyError(testCase, 5, 'some:id', '5 is not a function handle');
verifyError(testCase, @testCase.verifyFail, ...
    ?matlab.unittest.qualifications.AssertionFailedException, ...
    'Verifications dont throw exceptions.');
verifyError(testCase, @() error('SOME:id'), 'OTHER:id', 'Wrong id');
verifyError(testCase, @() error('whoops'), ...
    ?matlab.unittest.qualifications.AssertionFailedException, ...
    'Wrong type of exception thrown');

Условие ошибки тестирования

Создание testNonNumericInput чтобы проверить, выдает ли функция ожидаемое сообщение об ошибке, add5:InputMustBeNumericдля неожиданного условия вход char.

Функция для модульного тестирования:

function res = add5(x)
% ADD5 Increment input by 5.
if ~isa(x,'numeric')
    error('add5:InputMustBeNumeric','Input must be numeric.')
end
res = x + 5;
end

TestCase класс, содержащий методы тестирования:

classdef Add5Test < matlab.unittest.TestCase
    methods (Test)
        function testDoubleOut(testCase)
            actOutput = add5(1);
            testCase.verifyClass(actOutput,'double')
        end
        function testNonNumericInput(testCase)
            testCase.verifyError(@()add5('0'),'add5:InputMustBeNumeric')
        end
    end
end

Создайте тестовый набор из Add5Test файл класса.

suite = matlab.unittest.TestSuite.fromFile('Add5Test.m')

result = run(suite);

Running Add5Test
..
Done Add5Test
__________

Проверьте ошибки функции с слишком большим количеством запрошенных выходов

В текущей рабочей папке создайте следующую функцию для тестирования. Функция возвращает один выход.

function y = plusOne(x)
    y = x+1;
end

В командной строке вызовите plusOne с слишком большим количеством выходных аргументов.

[~,~] = plusOne(41);

Error using plusOne
Too many output arguments.

Просмотрите сообщение об ошибке и идентификатор.

MException.last

ans = 

  MException with properties:

    identifier: 'MATLAB:TooManyOutputs'
       message: 'Too many output arguments.'
         cause: {0×1 cell}
         stack: [0×1 struct]

Проверьте, что если plusOne вызывается функция со слишком большим количеством запрашиваемых выходных аргументов, она ошибается и ошибка имеет идентификатор MATLAB:TooManyOutputs.

testCase = matlab.unittest.TestCase.forInteractiveUse;
[~,~] = verifyError(testCase,@() plusOne(41),'MATLAB:TooManyOutputs');

Interactive verification passed.

Совет

Этот метод функционально эквивалентен:
```
import matlab.unittest.constraints.Throws;
verifiable.verifyThat(actual, Throws(identifier));
verifiable.verifyThat(actual, Throws(metaClass));
```
При использовании Throws существует больше функциональности ограничение непосредственно через verifyThat.
Используйте верификацию проверок для создания и записи отказов без выдачи исключения. Поскольку верификации не выдают исключения, все содержания теста запусков к завершению, даже когда верификация отказов произойти. Как правило, верификации типа «verification» являются основой для модульного теста, поскольку они обычно не требуют раннего выхода из теста. Используйте другие типы проверки для выявления нарушений предусловий или неправильной настройки теста. Кроме того,
- Используйте проверки типа «assumption», чтобы убедиться, что тестовая среда соответствует предусловиям, которые не приводят к непройденному тесту. Нарушение условий приводит к отфильтрованным тестам, а среда тестирования помечает тесты как Incomplete. Для получения дополнительной информации смотрите matlab.unittest.qualifications.Assumable.
- Используйте проверки типа утверждения, когда условие отказа делает недействительным оставшуюся часть текущего содержания теста, но не препятствует правильному выполнению последующих методов тестирования. При отказе в точке задания текущий метод тестирования становится неудачным и неполным. Для получения дополнительной информации смотрите matlab.unittest.qualifications.Assertable.
- Используйте критическое утверждение проверок, чтобы прервать тестовый сеанс после отказа. Эти типы проверки применяются, когда тип отказа настолько принципиален, что нет точки продолжать тестирование. Эти типы проверки также применяются фиксатором когда отключение не восстанавливает MATLAB^® состояние правильно, и лучше прекратить проверку и начать новую сессию. Для получения дополнительной информации смотрите matlab.unittest.qualifications.FatalAssertable.

См. также

Темы

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

Введенный в R2013a

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