@wdio/cli

What is @wdio/cli?

@wdio/cli is a command-line interface for WebdriverIO, a popular automation test framework for Node.js. It allows users to set up, configure, and run automated tests for web applications using WebdriverIO.

What are @wdio/cli's main functionalities?

Setup WebdriverIO

This command initializes a new WebdriverIO project by guiding the user through a series of prompts to configure the test environment, including selecting the test framework, reporter, and services.

npx wdio config

Run Tests

This command runs the tests defined in the WebdriverIO configuration file. It executes the test scripts and generates reports based on the specified configuration.

npx wdio run ./wdio.conf.js

Generate Test Reports

This command runs the tests and generates reports using the specified reporter, in this case, the 'spec' reporter. Users can choose from various reporters to format the test results.

npx wdio run ./wdio.conf.js --reporters spec

Debug Tests

This command runs the tests in debug mode, allowing users to step through their test scripts and troubleshoot issues interactively.

npx wdio run ./wdio.conf.js --debug

Other packages similar to @wdio/cli

cypress

Cypress is a front-end testing tool built for the modern web. It offers a rich, interactive interface for writing and running tests, and it provides features like time travel, real-time reloads, and automatic waiting. Unlike WebdriverIO, which uses the WebDriver protocol, Cypress operates directly in the browser, which can result in faster and more reliable tests.

nightwatch

Nightwatch.js is an integrated, easy-to-use End-to-End testing solution for web applications and websites, written in Node.js. It uses the W3C WebDriver API to perform commands and assertions on DOM elements. Nightwatch.js is similar to WebdriverIO in that it uses the WebDriver protocol, but it is known for its simplicity and ease of setup.

testcafe

TestCafe is a Node.js tool to automate end-to-end web testing. It works without WebDriver and is designed to be easy to set up and use. TestCafe runs tests in any browser that supports HTML5, and it provides a comprehensive set of features for writing and running tests, including parallel test execution and built-in support for ES6/ES7.

README

WDIO CLI

WebdriverIO testrunner command line interface

Changelog

v9.14.0 (2025-05-15)

:rocket: New Feature

• wdio-protocols, webdriver, webdriverio
  • #14478 feat(protocol): WebDriver Bidi Protocol update (@christian-bromann)

:bug: Bug Fix

• wdio-spec-reporter
  • #14472 chore(@wdio/spec-reporter): file name print format (@unickq)

:nail_care: Polish

• wdio-types
  • #14474 add browserstack camera-image-injection to wdio-types capabilities (@DoreyKiss)
• wdio-browserstack-service
  • #14466 Added changes to skip tests for mocha framework for browserstack session (@pri-gadhiya)

:house: Internal

• wdio-types
  • #14481 feat: adding check in normalizeDoc function to make sure readmeArr is of string type (@Kauanldsbarbosa)

Committers: 5

• Christian Bromann (@christian-bromann)
• Dory (@DoreyKiss)
• Kauan Barbosa (@Kauanldsbarbosa)
• Mykyta Chursin (@unickq)
• Priyanka Gadhiya (@pri-gadhiya)