verifyFail

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

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

Описание

пример

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

пример

verifyFail(testCase,diagnostic) также сопоставляет диагностическую информацию в diagnostic с проверкой.

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

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

Объект теста в виде экземпляра matlab.unittest.qualifications.Verifiable класс. Поскольку matlab.unittest.TestCase класс разделяет на подклассы matlab.unittest.qualifications.Verifiable и наследовал его методы, testCase обычно matlab.unittest.TestCase экземпляр.

Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои в виде массива строк, символьного массива, указателя на функцию или массива matlab.unittest.diagnostics.Diagnostic объекты.

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

Пример: "My Custom Diagnostic"

Пример: @dir

Примеры

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

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

В файле в вашей текущей папке создайте FeatureTest класс. Используйте verifyFail метод, чтобы добавить двух заполнителей, чтобы протестировать вашу новую возможность.

classdef FeatureTest < matlab.unittest.TestCase
    methods (Test)
        function defaultBehavior(testCase)
            testCase.verifyFail
        end
        function otherBehavior(testCase)
            testCase.verifyFail("Add code to test nondefault behavior.")
        end
    end
end

Если при запуске тесты, они оба сбой безусловно.

runtests("FeatureTest")
Running FeatureTest

================================================================================
Verification failed in FeatureTest/defaultBehavior.
    ------------------
    Stack Information:
    ------------------
    In C:\work\FeatureTest.m (FeatureTest.defaultBehavior) at 4
================================================================================
.
================================================================================
Verification failed in FeatureTest/otherBehavior.
    ----------------
    Test Diagnostic:
    ----------------
    Add code to test nondefault behavior.
    ------------------
    Stack Information:
    ------------------
    In C:\work\FeatureTest.m (FeatureTest.otherBehavior) at 7
================================================================================
.
Done FeatureTest
__________

Failure Summary:

     Name                         Failed  Incomplete  Reason(s)
    ==========================================================================
     FeatureTest/defaultBehavior    X                 Failed by verification.
    --------------------------------------------------------------------------
     FeatureTest/otherBehavior      X                 Failed by verification.

ans = 

  1×2 TestResult array with properties:

    Name
    Passed
    Failed
    Incomplete
    Duration
    Details

Totals:
   0 Passed, 2 Failed, 0 Incomplete.
   0.087462 seconds testing time.

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

В файле в вашей текущей папке создайте класс Handle с событием.

classdef MyHandle < handle
    events
        SomethingHappened
    end
end

В вашей текущей папке создайте ListenerTest класс. Добавьте код, чтобы создать источник события, прослушиватель для события и вспомогательный метод, который служит коллбэком прослушивателя. Затем добавьте два Test методы, чтобы протестировать поведение коллбэка, когда событие инициировано.

classdef ListenerTest < matlab.unittest.TestCase
    properties
        Source
        Listener
    end

    methods (TestMethodSetup)
        function setup(testCase)
            % Create the event source
            testCase.Source = MyHandle;
            % Add a listener to test execution of the callback code
            testCase.Listener = testCase.Source.addlistener( ...
                "SomethingHappened",@testCase.forbiddenCallback);
            % Remove the listener after the test
            testCase.addTeardown(@delete,testCase.Listener)
        end
    end

    methods (Test)
        function passingTest(testCase)
            % Disable the listener
            testCase.Listener.Enabled = false;
            testCase.Source.notify("SomethingHappened")   % Callback does not run
        end
        function failingTest(testCase)
            % The listener is enabled by default
            testCase.Source.notify("SomethingHappened")   % Callback runs
        end
    end

    methods
        function forbiddenCallback(testCase,~,~)
            % Test fails unconditionally
            testCase.verifyFail("This callback must not run!")
        end
    end
end

Запуск тестов. passingTest отключает прослушиватель и затем инициировал событие. Поэтому коллбэк не запускается, и тестовые передачи. Однако, когда failingTest инициировал событие, forbiddenCallback запуски, приводящие к отказу, который производится verifyFail.

runtests("ListenerTest")
Running ListenerTest
.
================================================================================
Verification failed in ListenerTest/failingTest.
    ----------------
    Test Diagnostic:
    ----------------
    This callback must not run!
    ------------------
    Stack Information:
    ------------------
    In C:\work\ListenerTest.m (ListenerTest.forbiddenCallback) at 34
    In C:\work\ListenerTest.m (@(varargin)testCase.forbiddenCallback(varargin{:})) at 13
    In C:\work\ListenerTest.m (ListenerTest.failingTest) at 27
================================================================================
.
Done ListenerTest
__________

Failure Summary:

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

ans = 

  1×2 TestResult array with properties:

    Name
    Passed
    Failed
    Incomplete
    Duration
    Details

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

Советы

  • Используйте проверку типа "verification" для создания и записи сбоев без выдачи исключения. Поскольку проверки не выдают исключения, все тесты выполняются до своего завершения, даже когда имеют место сбои в проверке. Как правило, проверки типа "verification" являются основой для модульного теста, поскольку они обычно не требуют раннего выхода из тестирования. Используйте другие типы проверки для выявления нарушений предварительных обязательных условий или неправильной настройки теста:

    • Используйте проверку типа "assumption", чтобы убедиться, что тестовая среда соответствует предварительным обязательным условиям, которые не приводят к ошибке тестирования. Нарушение условий приводит к фильтрации тестов, а среда тестирования помечает тесты как незавершенныеДля получения дополнительной информации см. matlab.unittest.qualifications. Assumable.

    • Используйте проверки типа утверждения, когда условие отказа будет делать недействительным остаток от текущего содержания теста, но не предотвратит соответствующее выполнение последующих тестов. Отказ в точке утверждения представляет текущий тест как Failed и IncompleteДля получения дополнительной информации см. matlab.unittest.qualifications. Assertable.

    • Используйте проверку типа "fatal assertion", чтобы прервать сеанс тестирования после сбоя. Эти проверки полезны, когда отказ является так основным, что продолжение тестирования не целесообразно. Проверки критического утверждения также полезны, когда отключение фиксатора не восстанавливает среду, правильно указывают, и прерывающий тестирование, и запуск новой сессии предпочтителен. Для получения дополнительной информации см. matlab.unittest.qualifications. FatalAssertable.

Введенный в R2013a
Для просмотра документации необходимо авторизоваться на сайте