exponenta event banner

assertAccessed

Класс: matlab.mock.StartCase
Пакет: matlab.mock

Подтверждение доступа к свойству

Описание

пример

assertAccessed(testcase,behavior) утверждает, что был получен доступ к свойству.

пример

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

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

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

Экземпляр тестового случая, указанный как matlab.mock.TestCase объект.

Поведение макета, указанного как matlab.mock.PropertyBehavior экземпляр. Создание экземпляра matlab.mock.PropertyBehavior, получить доступ к свойству объекта поведения.

Пример: behavior.PropertyFoo

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

Пример: "My diagnostic message."

Пример: @() datetime('now')

Примеры

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

Создание макета с неявным интерфейсом для интерактивного использования. Интерфейс включает в себя PropertyFoo и PropertyBar свойства. Доступ PropertyFoo путем сохранения его значения.

testCase = matlab.mock.TestCase.forInteractiveUse;
[mock,behavior] = testCase.createMock('AddedProperties', ...
    ["PropertyFoo","PropertyBar"]);
value = mock.PropertyFoo;

Утверждайте, что PropertyFoo был получен доступ.

testCase.assertAccessed(behavior.PropertyFoo);
Assertion passed.

Создание макета с неявным интерфейсом для интерактивного использования. Интерфейс включает в себя PropertyFoo и PropertyBar свойства. Доступ PropertyFoo путем сохранения его значения.

testCase = matlab.mock.TestCase.forInteractiveUse;
[mock,behavior] = testCase.createMock('AddedProperties', ...
    ["PropertyFoo","PropertyBar"]);
value = mock.PropertyFoo;

Утверждайте, что PropertyBar был получен доступ. Отображение диагностической информации при отказе.

testCase.assertAccessed(behavior.PropertyBar, ...
    'PropertyBar should have been accessed.');
Assertion failed.
    ----------------
    Test Diagnostic:
    ----------------
    PropertyBar should have been accessed.
    ---------------------
    Framework Diagnostic:
    ---------------------
    assertAccessed failed.
    --> Property 'PropertyBar' was never accessed.
    
    Specified property access operation:
    PropertyGetBehavior
        <Mock>.PropertyBar
Assertion failed.

Совет

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

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

  • Для проверки соответствия среды тестирования предварительным условиям, которые в противном случае не приведут к сбою теста, используйте квалификационные требования. Предполагаемые отказы приводят к отфильтрованным тестам, и платформа тестирования помечает тесты как Incomplete.

  • Используйте условия неустранимого утверждения, чтобы прервать тестовый сеанс при сбое. Эти требования полезны, когда режим отказа настолько фундаментален, что нет смысла продолжать тестирование. Эта квалификация также полезна, когда отрыв приспособления не восстанавливает состояние MATLAB ® правильно, и предпочтительно прервать тестирование и начать новую сессию.

Альтернативы

Использование assertAccessed функционально эквивалентен использованию matlab.mock.constraints.WasAccessed ограничение с помощью assertThat способ Assertable класс. Например, следующие кодовые блоки функционально эквивалентны.

% Using the assertAccessed method
testCase.assertAccessed(behavior.PropertyFoo);

% Using the WasAccessed constraint with assertThat method
import matlab.mock.constraints.WasAccessed;
testCase.assertThat(behavior.PropertyFoo,WasAccessed);
Однако при использовании WasAccessed ограничение. Например, можно указать свойство, к которому обращались определенное количество раз.

Представлен в R2017a