Nasal Piercings Manipulator


    2.5.0-beta • Public • Published

    WebdriverIO Build Status Coverage Status Gitter

    Selenium Test Status

    This library is a webdriver module for Node.js. It makes it possible to write super easy selenium tests in your favorite BDD or TDD test framework. It was originated by Camilo Tapia's inital selenium project called WebdriverJS.

    Have a look at the many examples.

    For news or announcements follow @webdriverio on Twitter.

    How to install it

    npm install webdriverio


    Make sure you have a running Selenium standalone/grid/hub. Or use selenium-standalone package to run one easily.

    Once you initialized your WebdriverIO instance you can chain all available protocol and action commands to execute asynchronous requests sequentially. WebdriverIO supports callback and promise based chaining. You can either pass a callback as last parameter to handle with the command results:

    var webdriverio = require('webdriverio');
    var options = {
        desiredCapabilities: {
            browserName: 'chrome'
    var client = webdriverio.remote(options);
        .getTitle(function(err, title) {
            console.log('Title was: ' + title);

    or you can handle it like a A+ promise:

            .then(function(title) {
                console.log('Title was: ' + title);
            .catch(function(error) {
                console.log('uups something went wrong', error);

    Using promised based assertion libraries like chai-as-promised it makes functional testing with WebdriverIO super easy. No nested callbacks anymore! No confusion whether to use callbacks or promises!

    describe('example page', function() {
        var chai = require('chai');
        var chaiAsPromised = require('chai-as-promised');
        chaiAsPromised.transferPromiseness = client.transferPromiseness;
        before(function() {
            return client.init().url('');
        it('should display right title and #someElem', function() {
            return client.getTitle().should.become('Example Title')
        after(function() {
            return client.end();

    If you're looking for a complete workflow example, this post explains a way to run tests using gulp, selenium-standalone, Mocha and WebdriverIO. If you want to use Cucumber for real BDD testing check out the cucumber-boilerplate project.



    Type: Object


    browserName: 'chrome',  // options: firefox, chrome, opera, safari
    version: '27.0',        // browser version
    platform: 'XP',         // OS platform
    tags: ['tag1','tag2'],  // specify some tags (e.g. if you use Sauce Labs)
    name: 'my test'         // set name for test (e.g. if you use Sauce Labs)

    See the Selenium documentation for a list of the available capabilities.


    Type: String

    Default: silent

    Options: verbose | silent | command | data | result


    Type: Boolean

    Default: true

    Enables colors for log output


    Saves a screenshot to a given path if Selenium driver crashes

    Type: String|null

    Default: null


    Type: Boolean

    Default: false

    Set to true if you always want to reuse the same remote


    Type: Number

    Default: 500

    Default timeout for all waitForXXX commands

    Selector API

    The JsonWireProtocol provides several strategies to query an element. WebdriverIO simplifies these to make it more familiar with the common existing selector libraries like Sizzle. The following selector types are supported:

    • CSS query selector
      e.g.'h2.subheading a', function(err,res) {...}) etc.
    • link text
      To get an anchor element with a specific text in it (f.i. <a href="">WebdriverIO</a>) query the text starting with an equal (=) sign. In this example use =WebdriverIO
    • partial link text
      To find a anchor element whose visible text partially matches your search value, query it by using *= in front of the query string (e.g. *=driver)
    • tag name
      To query an element with a specific tag name use <tag> or <tag />
    • name attribute
      For quering elements with a specific name attribute you can eather use a normal CSS3 selector or the provided name strategy from the JsonWireProtocol by passing something like [name="some-name"] as selector parameter
    • xPath
      It is also possible to query elements via a specific xPath. The selector has to have a format like for example //BODY/DIV[6]/DIV[1]/SPAN[1]

    In near future WebdriverIO will cover more selector features like form selector (e.g. :password,:file etc) or positional selectors like :first or :nth.

    List of current commands methods

    To see the full list of available commands check out the WebdriverIO API.


    WebdriverIO inherits several function from the NodeJS EventEmitter object. Additionally it provides an experimental way to register events on browser side (like click, focus, keypress etc.).


    The following functions are supported: on,once,emit,removeListener,removeAllListeners. They behave exactly as described in the official NodeJS docs. There are some predefined events (error,init,end, command) which cover important WebdriverIO events.


    client.on('error', function(e) {
        // will be executed everytime an error occured
        // e.g. when element couldn't be found
        console.log(e.body.value.class);   // -> "org.openqa.selenium.NoSuchElementException"
        console.log(e.body.value.message); // -> "no such element ..."

    All commands are chainable, so you can use them while chaining your commands

    var cnt;
        .once('countme', function(e) {
            console.log(e.elements.length, 'elements were found');
        .elements('.myElem', function(err,res) {
            cnt = res.value;
        .emit('countme', cnt)

    Note: make sure you check out the Browserevent side project that enables event-handling on client side (Yes, in the browser!! ;-).

    Adding custom commands

    If you want to extend the client with your own set of commands there is a method called addCommand available from the client object:

    var client = require("webdriverio").remote();
    // example: create a command the returns the current url and title as one result
    // last parameter has to be a callback function that needs to be called
    // when the command has finished (otherwise the queue stops)
    client.addCommand("getUrlAndTitle", function(customVar, cb) {
        this.url(function(err,urlResult) {
            this.getTitle(function(err,titleResult) {
                var specialResult = {url: urlResult.value, title: titleResult};
                console.log(customVar); // "a custom variable"
        .getUrlAndTitle('a custom variable', function(err,result){
            assert.equal(null, err)
            assert.strictEqual(result.title,'GitHub · Build software better, together.');

    Run multiple browser at the same time

    This feature isn't quite ready for release yet but it is already merged into master so you can already play arround with it. Checkout the example here.

    Selenium cloud providers

    WebdriverIO supports

    See the corresponding examples.

    How to run tests

    1. Download the latest Selenium standalone server and run it via

      $ java -jar selenium-server-standalone-2.41.0.jar
    2. Make sure you have all the dependencies installed

      $ npm install

      also all Bower packages required by our testpage

      cd test/site/www && bower install && cd ../../..
    3. Start a local server that delivers our test page to the browser. We recommend to use http-server

      cd /root/dir/of/webdriverio
      $ http-server -p 8080
    4. Depending on your feature/fix/patch make sure it gets covered by a test. To ensure that you can run one of the following commands:

      # if your patch is browser specific 
      # (e.g. upload files) 
      npm run-script test-desktop
      # if your patch is mobile specific 
      # (e.g. flick or swipe tests) 
      npm run-script test-mobile
      # if your patch is functional and hasn't something to do with Selenium 
      # (e.g. library specific fixes like changes within EventHandler.js) 
      npm run-script test-functional

      While developing you can run tests on specific specs by passing another environment variable _SPEC, e.g.

      $ _SPEC=test/spec/YOURSPEC.js npm run-script test-desktop

    NPM Maintainers

    The npm module for this library is maintained by:


    npm i webdriverio-master


    DownloadsWeekly Downloads






    Last publish


    • ngokevin