Быстрый старт

Установка

Запустите установщик testplane с помощью npm.

npm init testplane@latest YOUR_PROJECT_PATH

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

Настройка

После выполнения команды, указанной выше, в корне проекта сгенерится файл testplane.config.ts с базовой настройкой.

export default {
    // https://testplane.io/ru/docs/v8/guides/local-browsers/
    gridUrl: "local",
    baseUrl: "http://localhost",
    pageLoadTimeout: 0,
    httpTimeout: 60000,
    testTimeout: 90000,
    resetCursor: false,
    sets: {
        desktop: {
            files: ["testplane-tests/**/*.testplane.(t|j)s"],
            browsers: ["chrome", "firefox"],
        },
    },
    browsers: {
        chrome: {
            headless: true,
            desiredCapabilities: {
                browserName: "chrome",
            },
        },
        firefox: {
            headless: true,
            desiredCapabilities: {
                browserName: "firefox",
            },
        },
    },
    plugins: {
        "html-reporter/testplane": {
            // https://github.com/gemini-testing/html-reporter
            enabled: true,
            path: "testplane-report",
            defaultView: "all",
            diffMode: "3-up-scaled",
        },
    },
};

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

npx testplane install-deps

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

Создание теста

Перейдите в файл tests/example.testplane.js с тестом. В нем вы можете посмотреть пример теста или написать свой. Например,

describe("github", async function () {
    it("should find testplane", async function ({ browser }) {
        await browser.url("https://github.com/gemini-testing/testplane");
        const elem = await browser.$("#readme h1");

        await expect(elem).toHaveText("Testplane");
    });
});

Запуск теста

Теперь вы можете запустить тесты:

npx testplane

или запустить gui-режим и запустить тест через интерфейс в браузере

npx testplane gui