Быстрый старт
Установка
Запустите установщик testplane с помощью npm
.
npm init testplane@latest YOUR_PROJECT_PATH
Если вы не хотите использовать дефолты при инициализации проекта, а настроить его с помощью визарда, укажите опцию -v
.
Настройка
После выполнения команды, указанной выше, в корне проекта сгенерится файл .testplane.conf.js
с базовой настройкой. В зависимости от того, каким протоколом вы хотите воспользоваться, есть 2 варианта настройки (по умолчанию для браузера будет указан протокол CDP).
- Chrome Devtools Protocol
- WebDriver protocol
module.exports = {
sets: {
desktop: {
files: 'tests/desktop'
}
},
browsers: {
chrome: {
automationProtocol: 'devtools',
desiredCapabilities: {
browserName: 'chrome'
}
}
}
};
module.exports = {
gridUrl: 'http://localhost:4444/wd/hub',
sets: {
desktop: {
files: 'tests/desktop'
}
},
browsers: {
chrome: {
automationProtocol: 'webdriver', // default value
desiredCapabilities: {
browserName: 'chrome'
}
}
}
};
Создание теста
Перейдите в файл 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
Если при настройке конфига вы выбрали WebDriver protocol
, то перед запуском тестов у вас должен быть запущен (в отдельной вкладке) selenium-standalone
:
selenium-standalone start