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

Как записать параметризованные тесты

Классы, которые получают из matlab.unittest.TestCase класс может реализовать тестовую параметризацию, используя свойство среды и атрибуты метода. Чтобы предоставить данные как параметры в вашем основанном на классах тесте, задайте данные с помощью properties блок с соответствующим атрибутом параметризации. Затем передайте свойство параметризации как входной параметр одному или нескольким методам.

Для примера рассмотрим SampleTest класс. Класс задает параметризованный тест, потому что он задает свойство в properties блок со TestParameter атрибут. Свойство передается в Test способ и используется для выполнения проверки.

classdef SampleTest < matlab.unittest.TestCase
    properties (TestParameter)
        Number = {1,2,'3',4,5};
    end
    methods(Test)
        function testDouble(testCase,Number)
            testCase.verifyClass(Number,'double')
        end
    end
end

Потому что Number - массив ячеек с пятью элементами, тестовый класс результатов в параметризованном тестовом наборе с пятью элементами.

suite = testsuite('SampleTest');
{suite.Name}'

ans =

  5×1 cell array

    {'SampleTest/testDouble(Number=value1)'}
    {'SampleTest/testDouble(Number=value2)'}
    {'SampleTest/testDouble(Number=value3)'}
    {'SampleTest/testDouble(Number=value4)'}
    {'SampleTest/testDouble(Number=value5)'}

Значение, присвоенное свойству параметризации, должно быть либо непустым массивом ячеек, либо скалярной структурой с по крайней мере одним полем. MATLAB^® использует значение свойства, чтобы задать названия и значения параметра в тестовом наборе:

Как инициализировать свойства параметризации

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

Как только вы присвоите значение свойству параметризации, не изменяйте его. Для примера, когда вы инициализируете свойство параметризации с помощью значения по умолчанию, вы не можете использовать TestParameterDefinition метод для перезаписи значения по умолчанию.

Параметр может использоваться несколькими модульными тестами. Тесты, использующие тот же параметр, должны запускаться независимо, не оказывая случайного влияния друг на друга. В сложение текущий тест не должен влиять на последующие повторения того же теста. Чтобы гарантировать независимость тестового запуска, инициализируйте свойства параметризации с помощью объектов значений. Использование указателя объектов (таких как графические объекты MATLAB) в качестве значений параметров не рекомендуется. Для получения дополнительной информации о поведении объектов значение и указатель, смотрите Сравнение классов Handle и Value.

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

classdef FigureTest < matlab.unittest.TestCase
    properties (TestParameter)
        FigureType = {@figure, @uifigure};
    end
    methods(Test)
        function defaultCurrentPoint(testCase,FigureType)
            fig = FigureType();
            testCase.addTeardown(@close,fig)
            cp = fig.CurrentPoint;
            testCase.verifyEqual(cp,[0 0])
        end
    end
end

Задайте уровень параметризации

Можно параметризовать тестовый класс на трех уровнях: настройке класса, настройке метода и тесте. Параметризация на каждом уровне требует, чтобы свойства параметризации имели определенный атрибут свойства. Для примера, на самом высоком уровне, a TestClassSetup метод может быть параметризован с помощью свойства, заданного в properties блок со ClassSetupParameter атрибут. На самом низком уровне, a Test метод может быть параметризован с помощью свойства, заданного в properties блок со TestParameter атрибут.

В этой таблице показаны различные уровни параметризации и необходимые атрибуты метода и свойств для каждого уровня.

Параметризованный метод может получить доступ к свойствам параметризации в зависимости от уровня, на котором задан метод:

Пример параметризации тестового класса на разных уровнях см. в разделе «Создание расширенного параметризованного теста».

Задайте, как объединяются параметры

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

В этой таблице показаны различные стратегии комбинации параметров.

Можно объединить параметры на уровнях class-setup, method-setup и test. Для примера используйте объединенные атрибуты метода TestMethodSetup, ParameterCombination = 'sequential' для задания последовательной комбинации параметров уровня настройки метода, определенных в properties блок со MethodSetupParameter атрибут.

Для примеров того, как объединить тестовые параметры, смотрите, Создают Основной Параметризованный Тест и Создают Расширенный Параметризованный Тест.

Используйте внешние параметры в тестах

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