Конфиг Testplane

По умолчанию Testplane при запуске ищет файл .testplane.conf.ts или testplane.config.ts в текущей рабочей папке.

Вы можете задать свой конфигурационный файл с помощью CLI-опции --config.

Настройка

Чтобы настроить Testplane, необходимо задать хотя бы один браузер:

testplane.config.ts

import type { ConfigInput } from "testplane";

export default {
    browsers: {
        chrome: {
            desiredCapabilities: {
                browserName: "chrome",
            },
        },
    },
} satisfies ConfigInput;

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

testplane.config.ts

import type { ConfigInput } from "testplane";

export default {
    retry: process.env.IS_CI ? 5 : 0,

    httpTimeout: 60_000,
    sessionsPerBrowser: 5,
    testsPerSession: 20,

    browsers: {
        chrome: {
            desiredCapabilities: {
                browserName: "chrome",
                automationProtocol: "devtools",
                headless: true,
            },
        },
    },
    sets: {
        desktop: {
            files: ["testplane-tests/**/*.testplane.(t|j)s"],
            browsers: ["chrome"],
        },
    },
    plugins: {
        "html-reporter/testplane": {
            enabled: true,
        },
    },
} satisfies ConfigInput;

Справка по конфигурации

Единственным обязательным разделом в настройках Testplane является раздел browsers.

Все настройки браузеров (кроме desiredCapabilities) можно вынести на глобальный уровень, чтобы они применялись для всех браузеров. Например, это удобно для задания тайм-аутов для всех браузеров сразу.

Имя	Описание
browsers	Обязательный раздел. В нем задаются настройки всех браузеров, в которых будут запускаться тесты.
sets	Раздел, позволяющий привязать набор тестов к определенным браузерам и запускать их сразу одной командой. Может пригодиться, например, для отдельного запуска десктопных и мобильных тестов.
system	Раздел системных настроек Testplane. Позволяет задать число подпроцессов, в которых будут запускаться тесты, включить режим дебага для WebDriver, и многое другое.
plugins	Раздел, с помощью которого можно подключить к testplane внешние плагины.
prepareBrowser	Функция, в которой можно подготовить браузер до того, как в нем будут запущены тесты. Например, в этой функции можно добавить новые команды для объекта browser.
prepareEnvironment	Функция, в которой можно задать переменные окружения или, например, дополнить какие-то параметры конфига.
devServer	Раздел для настройки автоматического запуска dev сервера перед прогоном тестов.
lastFailed	Раздел для конфигурирования перезапуска только упавших тестов.

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