webdriverio 0,7,3,1,10,3,4 editorconfig eslint travis-ci npm

A Node.js bindings implementation for the W3C WebDriver protocol



Build Status NPM version Dependency Status [npm]() [Coveralls]() Gitter

Selenium Test Status

Homepage | Developer Guide | API Reference | Contribute

This library is a Webdriver (browser automation) module for Node.JS. It makes it possible to write super easy Selenium) tests in your favorite BDD/TDD test framework, that will run locally or in the cloud using Sauce Labs, BrowserStack or TestingBot.

WebdriverIO is agnostic with regards to the test framework you want to use. Cucumber, Jasmine and Mocha+Chai are supported by the configuration wizard.


npm install webdriverio

or if you want to use the wdio test runner

npm install -g webdriverio

Getting started

Simply run wdio config and the configuration helper wizard will get you set up:

wdio wizard

With all that done, have a look at the many examples.


Grunt Integration Gulp Integration Sublime Text Plugin Atom.io Plugin Visual Regression Testing with Applitools Eyes WebRTC Analytics Plugin

Syntax example


Notice how this is far simpler than with the original selenium-webdriverjs,


and significantly simpler than with WD.js:


For more details on the comparison between WebdriverIO, selenium-webdriverjs and WD.js, read this discussion. Also see more WebdriverIO examples in the example folder.

Need help?

If you have questions or any problems using WebdriverIO join the Gitter Chat, hit us contributor on Twitter or just file an issue on Github. We will try to get back to you as soon as possible.

Also if you miss any feature, let us know so we can make WebdriverIO even better. For news or announcements check @WebdriverIO on Twitter.

NPM Maintainers

The npm module for this library is maintained by:


WebdriverIO was originated by Camilo Tapia’s initial Selenium project called WebdriverJS, which was the first webdriver project on NPM. In 2014, the project was renamed WebdriverIO later on.



Related Repositories



A Node.js bindings implementation for the W3C WebDriver protocol ...



Regression testing tool for WebdriverIO ...



Boilerplate project to run WebdriverIO tests with Cucumber ...



grunt-webdriver is a grunt plugin to run selenium tests with the WebdriverIO testrunner ...



gulp-webdriver is a gulp plugin to run selenium tests with the WebdriverIO testrunner ...

Top Contributors

christian-bromann vvo camme georgecrawford dandv patthiel danjenkins ysono agauthiez Robinfr hanneshal amilajack j0tunn Risto-Stevcev filaraujo kurtharriger compulim csoete uniqueid001 sbmaxx apergy mdu Marius786 monolithed DenisGorbachev testingbot graingert Sanjo paazmaya nyarasha


package version
archiver ~1.3.0
babel-runtime ~6.23.0
css-parse ~2.0.0
css-value ~0.0.1
deepmerge ~1.3.2
ejs ~2.5.6
gaze ~1.1.2
glob ~7.1.1
inquirer ~3.1.0
json-stringify-safe ~5.0.1
mkdirp ~0.5.1
npm-install-package ~2.1.0
optimist ~0.6.1
q ~1.5.0
request ~2.81.0
rgb2hex ~0.1.0
safe-buffer ~5.0.1
supports-color ~3.2.3
url ~0.11.0
validator ~7.0.0
wdio-dot-reporter ~0.0.8
wgxpath ~1.0.0
dev babel-cli ^6.24.1
babel-core ^6.24.1
babel-eslint ^7.2.1
babel-plugin-add-module-exports ^0.2.1
babel-plugin-transform-runtime ^6.23.0
babel-preset-env ^1.3.3
babel-preset-stage-0 ^6.24.1
babel-register ^6.24.1
chai ^3.5.0
chai-as-promised ^6.0.0
chai-string ^1.3.0
chai-things ^0.2.0
codeclimate-test-reporter ^0.4.1
cordova ^6.5.0
coveralls ^2.13.0
eslint ^3.19.0
eslint-config-standard ^10.2.1
eslint-plugin-chai-expect ^1.1.1
eslint-plugin-import ^2.2.0
eslint-plugin-mocha ^4.9.0
eslint-plugin-node ^4.2.2
eslint-plugin-promise ^3.5.0
eslint-plugin-standard ^3.0.1
isparta ^4.0.0
istanbul ^0.4.5
mocha ^3.2.0
mock-require ^2.0.2
nock ^9.0.13
node-static ^0.7.9
np 2.13.2
npm-run-all ^4.0.2
sauce-connect-launcher ^1.2.1
saucelabs ^1.4.0
sinon ^2.1.0
snyk ^1.28.0
wdio-mocha-framework ^0.5.9


-   v4.2.16 zip tar
-   v4.2.15 zip tar
-   v4.2.14 zip tar
-   v4.2.13 zip tar
-   v4.2.12 zip tar
-   v4.2.11 zip tar
-   v4.2.10 zip tar
-   v4.2.9 zip tar
-   v4.2.8 zip tar
-   v4.2.7 zip tar
-   v4.2.6 zip tar
-   v4.2.5 zip tar
-   v4.2.4 zip tar
-   v4.2.3 zip tar
-   v4.2.2 zip tar
-   v4.2.1 zip tar
-   v4.2.0 zip tar
-   v4.1.1 zip tar
-   v4.1.0 zip tar
-   v4.0.9 zip tar
-   v4.0.8 zip tar
-   v4.0.7 zip tar
-   v4.0.6 zip tar
-   v4.0.5 zip tar
-   v4.0.4 zip tar
-   v4.0.4-4 zip tar
-   v4.0.3 zip tar
-   v4.0.2 zip tar
-   v4.0.1 zip tar
-   v4.0.0 zip tar