sets

Обзор

Вы можете использовать сеты (sets), чтобы привязать набор тестов к определенным браузерам и запускать их сразу одной командой — testplane --set <set-name>.

Это может быть удобно для запуска тестов по платформам: desktop, touch-phone и т. п. Также у вас может быть common сет, соответствующий общим тестам, которые вы будете запускать всегда во всех браузерах.

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

Если сетов в конфиге не будет, или вы не укажете их при запуске Testplane (см. раздел «Использование»), то будут запущены все тесты из папки testplane во всех браузерах, которые были указаны в разделе browsers конфига Testplane.

Настройка

Раздел sets имеет следующий формат:

testplane.config.ts

import type { ConfigInput } from "testplane";

export default {
    browsers: {
        /* ... */
    },
    sets: {
        "<set-id>": {
            files: ["path-1", "some/folder/**/*.some-ext"],
            ignoreFiles: ["ignorePath-1", "some/ignore/folder/**/"],
            browsers: ["browser-1", "browser-2"],
        },
    },
} satisfies ConfigInput;

Где <set-id> — это имя сета, которое используется для его идентификации.

Справка по секции sets

Параметр	Тип	По умолчанию	Описание
files	string | string[]	N/A	Список путей к файлам или папкам с тестами. В случае одного пути параметр можно задавать как строку. Также можно использовать маски.
ignoreFiles	string | string[]	[ ]	Список путей или масок, которые нужно игнорировать при поиске файлов с тестами. Данный параметр позволяет ускорить чтение тестов Testplane.
browsers	string[]	все браузеры	Список браузеров, в которых будут запускаться тесты. Можно указывать только браузеры, которые есть в разделе browsers конфига Testplane. По умолчанию: все браузеры из раздела browsers.

Пример настройки

testplane.config.ts

import type { ConfigInput } from "testplane";

export default {
    browsers: {
        chrome: {
            /*...*/
        },
        firefox: {
            /*...*/
        },
        iphone: {
            /*...*/
        },
    },
    sets: {
        common: {
            files: "tests/common/*.testplane.ts",
        },
        desktop: {
            files: ["tests/desktop/*.testplane.ts", "tests/common/*.testplane.ts"],
            ignoreFiles: ["**/screens/**"],
            browsers: ["chrome", "firefox"],
        },
    },
} satisfies ConfigInput;

В данном примере сет common содержит все тесты в директории common и будет запускаться во всех браузерах. Сет desktop содержит все тесты в директория common и desktop, но будет запускаться только в chrome и firefox.

Использование

Используйте CLI-опцию --set, чтобы указать сет при запуске тестов.

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

testplane --set desktop

Если в конфиге нет сетов, или они есть, но опция --set не была указана, и testplane не были переданы пути через CLI, то будут запущены все тесты из папки testplane во всех браузерах.