WebdriverIO
===========
[](https://travis-ci.org/webdriverio/webdriverio) [](http://badge.fury.io/js/webdriverio) [](https://www.versioneye.com/user/projects/58932ea4b166b50039982a32) []() []() [](https://gitter.im/webdriverio/webdriverio?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[](https://saucelabs.com/u/webdriverio)
***
#### [Homepage](http://webdriver.io) | [Developer Guide](http://webdriver.io/guide.html) | [API Reference](http://webdriver.io/api.html) | [Contribute](http://webdriver.io/contribute.html)
This library is a [webdriver](https://w3c.github.io/webdriver/webdriver-spec.html)
(browser automation) module for Node.JS. It makes it possible to write
super easy [Selenium](https://en.wikipedia.org/wiki/Selenium_(software)) 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.
## Installation
```shell
npm install webdriverio
```
or if you want to use the wdio test runner
```shell
npm install -g webdriverio
```
## Getting started
Simply run `wdio config` and the configuration helper wizard will get you set up:
With all that done, have a look at the many [examples](examples/).
## Plugins
[](https://github.com/webdriverio/grunt-webdriver)
[](https://github.com/webdriverio/gulp-webdriver)
[](https://packagecontrol.io/packages/WebdriverIO)
[](https://atom.io/packages/webdriverio-snippets)
[](https://github.com/webdriverio/webdrivercss#applitools-eyes-support)
[](https://github.com/webdriverio/webdriverrtc)
## Syntax example
```js
browser.url('http://google.com');
$('#q').setValue('webdriver');
$('#btnG').click();
```
Notice how this is far simpler than with the original [selenium-webdriverjs](https://github.com/SeleniumHQ/selenium/wiki/WebDriverJs),
```js
driver.get('http://www.google.com');
driver.findElement(webdriver.By.id('q')).sendKeys('webdriver');
driver.findElement(webdriver.By.id('btnG')).click();
```
and significantly simpler than with [WD.js](https://github.com/admc/wd):
```js
browser
.get("http://www.google.com")
.elementById('q')
.sendKeys('webdriver')
.elementById('btnG')
.click()
```
For more details on the comparison between WebdriverIO, selenium-webdriverjs and WD.js,
read [this discussion](https://github.com/webdriverio/webdriverio/issues/138). Also see more WebdriverIO examples in the [example folder](https://github.com/webdriverio/webdriverio/tree/master/examples).
## Need help?
If you have questions or any problems using WebdriverIO join the [Gitter Chat](https://gitter.im/webdriverio/webdriverio), hit us contributor on
Twitter or just file an [issue](https://github.com/webdriverio/webdriverio/issues) 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](http://twitter.com/webdriverio) on Twitter.
## NPM Maintainers
The [npm module](https://www.npmjs.com/package/webdriverio) for this library is maintained by:
* [Christian Bromann](https://github.com/christian-bromann)
* [George Crawford](https://github.com/georgecrawford)
* [Vincent Voyer](https://github.com/vvo)
* [Camilo Tapia](http://github.com/Camme)
## History
WebdriverIO was originated by [Camilo Tapia's](https://github.com/camme) initial
Selenium project called WebdriverJS, which was the first webdriver project on NPM.
In 2014, the project was renamed WebdriverIO later on.
### License
MIT