Установка и настройка

Системные требования

Чтобы начать работу с testplane, установите Node.js версии 18.0 и выше.

Установка

Для запуска установщика testplane с помощью npm выполните следующую команду:

npm init testplane@latest YOUR_PROJECT_PATH

Чтобы настроить проект, а не использовать дефолты при его инициализации, укажите опцию -v.

После выполнения команды установки в директории проекта появится следующий набор файлов и папок:

node_modules
testplane-tests
    example.testplane.ts
    ts.config.json
package-lock.json
package.json
testplane.config.ts

Настройка

В файле testplane.config.ts содержится базовый набор настроек для запуска тестов:

export default {
    gridUrl: "local",
    baseUrl: "http://localhost",
    pageLoadTimeout: 0,
    httpTimeout: 60000,
    testTimeout: 90000,
    resetCursor: false,

    // В параметре sets содержится информация о директории, в которой находятся тесты
    // и перечень браузеров, в которых они будут запускаться:
    sets: {
        desktop: {
            files: ["testplane-tests/**/*.testplane.(t|j)s"],
            browsers: ["chrome", "firefox"],
        },
    },

    // В поле `browsers` описана конфигурация используемых браузеров:
    browsers: {
        chrome: {
            headless: true,
            desiredCapabilities: {
                browserName: "chrome",
            },
        },
        firefox: {
            headless: true,
            desiredCapabilities: {
                browserName: "firefox",
            },
        },
    },

    plugins: {
        "html-reporter/testplane": {
            enabled: true,
            path: "testplane-report",
            defaultView: "all",
            diffMode: "3-up-scaled",
        },
    },
};

Чтобы загрузить браузеры, описанные в конфиге, отдельно от запуска самого Testplane, выполните команду:

npx testplane install-deps

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