verifyFail

Класс: matlab.unittest.qualifications.Verifiable
Пакет: matlab.unittest.qualifications

Произведите безусловный отказ верификации

Синтаксис

verifyFail(verifiable) verifyFail(verifiable,diagnostic)

Описание

verifyFail(verifiable) производит безусловный отказ верификации, когда столкнуто.

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

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

verifiable

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

diagnostic

Диагностическая информация, относящаяся к проверке, указывается как одно из следующего:

массив строк
массив символов
указатель на функцию
matlab.unittest.diagnostics.Diagnostic объект

Значения диагностики могут быть нескалярными. Для получения дополнительной информации см. Matlab.unittest.diagnostics.Diagnostic.

Примеры

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

Тестирование на условие отказа

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

Создайте класс Handle, MyHandle, с SomethingHappened событие.

classdef MyHandle < handle
    events
        SomethingHappened
    end
end

Создайте файл, ListenerTest, на вашем пути MATLAB^®, который содержит следующий TestCase класс.

classdef ListenerTest < matlab.unittest.TestCase
    methods(Test)
        function testDisabledListeners(testCase)
            h = MyHandle;
            
            % Add a listener to a test helper method
            listener = h.addlistener('SomethingHappened', ...
                @testCase.shouldNotGetCalled);
            
            % Passing scenario (code path is not reached)
            %%%%%%%%%%%%%%%%%%%%
            % Disabled listener should not invoke callbacks
            listener.Enabled = false;
            h.notify('SomethingHappened');
            
            % Failing scenario (code path is reached)
            %%%%%%%%%%%%%%%%%%%%
            % Enabled listener invoke callback and fail
            listener.Enabled = true;
            h.notify('SomethingHappened');
        end
    end
    
    methods
        function shouldNotGetCalled(testCase, ~, ~)
            % A test helper callback method that should not execute
            testCase.verifyFail('This listener callback should not have executed');
        end
    end
    
end

От командной строки, запущенной тест.

run(ListenerTest);

Running ListenerTest

================================================================================
Verification failed in ListenerTest/testDisabledListeners.

    ----------------
    Test Diagnostic:
    ----------------
    This listener callback should not have executed

    ------------------
    Stack Information:
    ------------------
    In C:\Desktop\ListenerTest.m (ListenerTest.shouldNotGetCalled) at 27
    In C:\\Desktop\ListenerTest.m (@(varargin)testCase.shouldNotGetCalled(varargin{:})) at 8
    In C:\Desktop\ListenerTest.m (ListenerTest.testDisabledListeners) at 20
================================================================================
.
Done ListenerTest
__________

Failure Summary:

     Name                                Failed  Incomplete  Reason(s)
    =================================================================================
     ListenerTest/testDisabledListeners    X                 Failed by verification.

Советы

Используйте проверку типа "verification" для создания и записи сбоев без выдачи исключения. Поскольку проверки не выдают исключения, все тесты выполняются до своего завершения, даже когда имеют место сбои в проверке. Как правило, проверки типа "verification" являются основой для модульного теста, поскольку они обычно не требуют раннего выхода из тестирования. Используйте другие типы проверки для выявления нарушений предварительных обязательных условий или неправильной настройки теста. В качестве варианта,
- Используйте проверку типа "assumption", чтобы убедиться, что тестовая среда соответствует предварительным обязательным условиям, которые не приводят к ошибке тестирования. Нарушение условий приводит к фильтрации тестов, а среда тестирования помечает тесты как незавершенныеДля получения дополнительной информации см. matlab.unittest.qualifications. Assumable.
- Используйте проверку типа "assertion", когда состояние отказа делает недействительным оставшуюся часть текущего теста, но не препятствует правильному выполнению последующих видов тестирования. Сбой в точке утверждения показывает, что текущий метод тестирования является неудачным и неполным. Для получения дополнительной информации см. matlab.unittest.qualifications. Assertable.
- Используйте проверку типа "fatal assertion", чтобы прервать сеанс тестирования после сбоя. Эти типы проверки применяются, когда характер отказа настолько принципиален, что нет смысла продолжать тестирование. Эти проверки также полезны, когда отключение фиксатора не восстанавливает MATLAB, правильно указывают и желательно прерывать тестирование и запускать новую сессию. Для получения дополнительной информации см. matlab.unittest.qualifications. FatalAssertable.

Темы

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

Введенный в R2013a

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