Тестраннер
WebdriverIO поставляется с собственным тестраннером, чтобы помочь вам начать тестирование как можно быстре е. Он предназначен для выполнения всей работы за вас, позволяет интегрироваться с сторонними сервисами и помогает запускать тесты максимально эффективно.
Тестраннер WebdriverIO распространяется отдельно в NPM-пакете @wdio/cli.
Установите его так:
- npm
- Yarn
- pnpm
- Bun
npm install @wdio/cli
yarn add @wdio/cli
pnpm add @wdio/cli
bun add @wdio/cli
Чтобы увидеть справку по интерфейсу командной строки, введите следующую команду в терминале:
$ npx wdio --help
wdio <command>
Commands:
wdio config Initialize WebdriverIO and setup configuration in
your current project.
wdio install <type> <name> Add a `reporter`, `service`, or `framework` to
your WebdriverIO project
wdio repl <option> [capabilities] Run WebDriver session in command line
wdio run <configPath> Run your WDIO configuration file to initialize
your tests.
Options:
--version Show version number [boolean]
--help Show help [boolean]
Отлично! Теперь вам нужно определить файл конфигурации, в котором будут указаны все данные о ваших тестах, возможностях и настройках. Перейдите к разделу Файл конфигурации, чтобы узнать, как должен выглядеть этот файл.
С помощью утилиты настройки wdio создать файл конфигурации очень легко. Просто запустите:
$ npx wdio config
...и запустится вспомогательная утилита.
Она задаст вам вопросы и сгенерирует файл конфигурации менее чем за минуту.
После настройки файла конфигурации вы можете запустить тесты командой:
npx wdio run wdio.conf.js
Вы также можете инициализировать запуск тестов без команды run:
npx wdio wdio.conf.js
Вот и всё! Теперь вы можете получить доступ к экземпляру selenium через глобальную переменную browser.
Команды
wdio config
Команда config запускает помощник настройки WebdriverIO. Этот помощник задаст несколько вопросов о вашем проекте WebdriverIO и создаст файл wdio.conf.js на основе ваших ответов.
Пример:
wdio config
Опции:
--help выводит меню помощи WebdriverIO [boolean]
--npm Устанавливать пакеты с помощью NPM вместо yarn [boolean]
wdio run
Это команда по умолчанию для запуска вашей конфигурации.
Команда run инициализирует файл конфигурации WebdriverIO и запускает ваши тесты.
Пример:
wdio run ./wdio.conf.js --watch
Опции:
--help выводит меню помощи WebdriverIO [boolean]
--version выводит версию WebdriverIO [boolean]
--hostname, -h адрес хоста автоматизации [string]
--port, -p порт драйвера автоматизации [number]
--user, -u имя пользователя при использовании облачного сервиса
в качестве бэкенда автоматизации [string]
--key, -k соответствующий ключ доступа для пользователя [string]
--watch следить за изменениями в спеках [boolean]
--logLevel, -l уровень подробности логирования
[варианты: "trace", "debug", "info", "warn", "error", "silent"]
--bail остановить тестраннер после определенного количества
неудачных тестов [number]
--baseUrl сокращение вызовов команд url путем установки базового url [string]
--waitforTimeout, -w таймаут для всех команд waitForXXX [number]
--framework, -f определяет фреймворк (Mocha, Jasmine или Cucumber)
для запуска тестов [string]
--reporters, -r репортеры для вывода результатов в stdout [array]
--suite переопределяет атрибут specs и запускает определенный
набор тестов [array]
--spec запустить определенный spec-файл или с использованием
масок - переопределяет specs из stdin [array]
--exclude исключить spec-файл(ы) из запуска - переопределяет specs
из stdin [array]
--repeat Повторить определенные specs и/или suites N раз [number]
--mochaOpts Опции Mocha
--jasmineOpts Опции Jasmine
--cucumberOpts Опции Cucumber
--tsConfigPath Пользовательский путь к `tsconfig.json` или использование
настройки [tsConfigPath](/docs/configurationfile) в конфигурации wdio
Примечание: Автокомпиляция может легко контролироваться с помощью переменных среды
tsx. См. также документацию по TypeScript.
wdio install
Команда install позволяет добавлять репортеры и сервисы в ваши проекты WebdriverIO через CLI.
Пример:
wdio install service sauce # устанавливает @wdio/sauce-service
wdio install reporter dot # устанавливает @wdio/dot-reporter
wdio install framework mocha # устанавливает @wdio/mocha-framework
Если вы хотите установить пакеты с помощью yarn, вы можете передать флаг --yarn в команду:
wdio install service sauce --yarn
Вы также можете указать пользовательский путь к конфигурации, если ваш файл конфигурации WDIO находится не в той папке, в которой вы работаете:
wdio install service sauce --config="./path/to/wdio.conf.js"
Список поддерживаемых сервисов
sauce
testingbot
firefox-profile
devtools
browserstack
appium
intercept
zafira-listener
reportportal
docker
wiremock
lambdatest
vite
nuxt
Список поддерживаемых репортеров
dot
spec
junit
allure
sumologic
concise
reportportal
video
html
json
mochawesome
timeline
Список поддерживаемых фреймворков
mocha
jasmine
cucumber
wdio repl
Команда repl позволяет запустить интерактивный интерфейс командной строки для выполнения команд WebdriverIO. Она может использоваться для тестирования или для быстрого создания сессии WebdriverIO.
Запуск тестов в локальном chrome:
wdio repl chrome
или запуск тестов на Sauce Labs:
wdio repl chrome -u $SAUCE_USERNAME -k $SAUCE_ACCESS_KEY
Вы можете применять те же аргументы, что и в команде run.
