Начало работы

Добро пожаловать в документацию WebdriverIO. Она поможет вам быстро начать работу. Если у вас возникнут проблемы, вы можете найти помощь и ответы на нашем сервере поддержки Discord или связаться со мной в Twitter.

информация

Это документация для последней версии (>=9.x) WebdriverIO. Если вы все еще используете более старую версию, пожалуйста, посетите старые версии документации!

Официальный YouTube канал 🎥

Вы можете найти больше видео о WebdriverIO на официальном YouTube канале. Не забудьте подписаться!

Инициализация настройки WebdriverIO

Чтобы добавить полную настройку WebdriverIO в существующий или новый проект с помощью WebdriverIO Starter Toolkit, выполните:

Если вы находитесь в корневом каталоге существующего проекта, выполните:

NPM

npm init wdio@latest .

или если вы хотите создать новый проект:

npm init wdio@latest ./path/to/new/project

Yarn

yarn create wdio .

или если вы хотите создать новый проект:

yarn create wdio ./path/to/new/project

pnpm

pnpm create wdio@latest .

или если вы хотите создать новый проект:

pnpm create wdio@latest ./path/to/new/project

bun

bun create wdio@latest .

или если вы хотите создать новый проект:

bun create wdio@latest ./path/to/new/project

Эта единственная команда загружает инструмент WebdriverIO CLI и запускает мастер конфигурации, который поможет вам настроить ваш набор тестов.

Мастер задаст ряд вопросов, которые проведут вас через настройку. Вы можете передать параметр --yes, чтобы выбрать настройку по умолчанию, которая будет использовать Mocha с Chrome, используя паттерн Page Object.

NPM

npm init wdio@latest . -- --yes

Yarn

yarn create wdio . --yes

pnpm

pnpm create wdio@latest . --yes

bun

bun create wdio@latest . --yes

Установка CLI вручную

Вы также можете добавить пакет CLI в ваш проект вручную с помощью:

npm i --save-dev @wdio/cli
npx wdio --version # выводит, например, `8.13.10`

# запустить мастер конфигурации
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 и использовать его как пакет, например, для создания скриншота веб-сайта:

getting-started/run-in-script.js

loading...

View on GitHub

Примечание: все команды WebdriverIO асинхронные и должны быть правильно обработаны с использованием async/await.

Запись тестов

WebdriverIO предоставляет инструменты, помогающие начать работу путем записи ваших тестовых действий на экране и автоматического создания тестовых скриптов WebdriverIO. Смотрите Запись тестов с помощью Chrome DevTools Recorder для получения дополнительной информации.

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

Вам понадобится установленный Node.js.

• Установите версию не ниже v18.20.0, так как это самая старая активная версия LTS
• Официально поддерживаются только выпуски, которые являются или станут выпусками LTS

Если Node в настоящее время не установлен в вашей системе, мы предлагаем использовать такой инструмент, как NVM или Volta, чтобы помочь в управлении несколькими активными версиями Node.js. NVM - популярный выбор, в то время как Volta также является хорошей альтернативой.