Початок роботи
Ласкаво просимо до документації WebdriverIO. Вона допоможе вам швидко розпочати роботу. Якщо у вас виникнуть проблеми, ви можете знайти допомогу та відповіді на нашому Discord сервері підтримки або написати мені у Twitter.
Це документація для останньої версії (>=9.x) WebdriverIO. Якщо ви все ще використовуєте старішу версію, відвідайте старі веб-сайти документації!
Ви можете знайти більше відео про WebdriverIO на офіційному YouTube каналі. Не забудьте підписатися!
Ініціалізація налаштування WebdriverIO
Щоб додати повне налаштування WebdriverIO до існуючого або нового проекту за допомогою WebdriverIO Starter Toolkit, виконайте:
Якщо ви знаходитесь у кореневому каталозі існуючого проекту, виконайте:
- NPM
- Yarn
- pnpm
- bun
npm init wdio@latest .
або якщо ви хочете створити новий проект:
npm init wdio@latest ./path/to/new/project
yarn create wdio .
або якщо ви хочете створити новий проект:
yarn create wdio ./path/to/new/project
pnpm create wdio@latest .
або якщо ви хочете створити новий проект:
pnpm create wdio@latest ./path/to/new/project
bun create wdio@latest .
або якщо ви хочете створити новий проект:
bun create wdio@latest ./path/to/new/project
Ця одна команда завантажує інструмент WebdriverIO CLI та запускає майстер конфігурації, який допомагає налаштувати ваш тестовий набір.
Майстер запропонує набір запитань, які проведуть вас через налаштування. Ви можете передати параметр --yes
, щоб вибрати налаштування за замовчуванням, яке використовуватиме Mocha з Chrome, використовуючи патерн Page Object.
- NPM
- Yarn
- pnpm
- bun
npm init wdio@latest . -- --yes
yarn create wdio . --yes
pnpm create wdio@latest . --yes
bun create wdio@latest . --yes
Встановлення CLI вручну
Ви також можете додати пакет CLI до свого проекту вручну через:
npm i --save-dev @wdio/cli
npx wdio --version # prints e.g. `8.13.10`
# run configuration wizard
npx wdio config
Запуск тесту
Ви можете запустити свій тестовий набір, використовуючи команду run
та вказавши на налаштування WebdriverIO, які ви щойно створили:
npx wdio run ./wdio.conf.js
Якщо ви хочете запустити певні тестові файли, ви можете додати параметр --spec
:
npx wdio run ./wdio.conf.js --spec example.e2e.js
або визначити набори у вашому файлі конфігурації та запустити лише тестові файли, визначені у наборі:
npx wdio run ./wdio.conf.js --suite exampleSuiteName
Запуск у скрипті
Якщо ви хочете використовувати WebdriverIO як двигун автоматизації в Автономному режимі у скрипті Node.JS, ви також можете напряму встановити WebdriverIO та використовувати його як пакет, наприклад, для створення скріншоту веб-сайту:
loading...
Примітка: всі команди WebdriverIO є асинхронними і потребують правильної обробки за допомогою async/await
.
Запис тестів
WebdriverIO надає інструменти, які допоможуть вам почати роботу, записуючи ваші тестові дії на екрані та автоматично генеруючи тестові скрипти WebdriverIO. Дивіться Запис тестів з Chrome DevTools Recorder для отримання додаткової інформації.
Системні вимоги
Вам потрібно встановити Node.js.
- Встановіть принаймні v18.20.0 або вище, оскільки це найстаріша активна версія LTS
- Офіційно підтримуються лише релізи, які є або стануть релізами LTS
Якщо Node зараз не встановлено у вашій системі, ми пропонуємо використовувати такий інструмент, як NVM або Volta, щоб допомогти керувати кількома активними версіями Node.js. NVM - популярний вибір, а Volta також є хорошою альтернативою.