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

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

Классы, которые выводят из 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) как значения параметров не рекомендуется. Для получения дополнительной информации о поведении значения и объектов указателя, смотрите Сравнение Классов Указателя и Значения.

Если необходимо протестировать объекты указателя в параметрированном тесте, рассмотрите построение их косвенно при помощи указателей на функцию как значения параметров и вызов тех указателей на функцию в тестах. Например, запишите параметрированный тест, чтобы протестировать текущую точку по умолчанию фигур, созданных с 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

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

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

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

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

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

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

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

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

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

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

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

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