Developer Guide

Welcome to the WebdriverIO documentation. It will help you to get started fast. If you run into problems you can find help and answers on our Gitter Channel or you can hit me on Twitter. The following will give you a short step by step introduction to get your first WebdriverIO script up and running.

Let’s suppose you have Node.js and Java already installed. First thing we need to do is to start a selenium server that executes all selenium commands within the browser. To do so we create an example folder first:

1. Create a simple test folder

1

$ mkdir webdriverio-test && cd webdriverio-test

Then let’s download the current selenium standalone server version:

2. Download selenium standalone server

1

$ curl -O http://selenium-release.storage.googleapis.com/2.47/selenium-server-standalone-2.47.0.jar

Start the server by executing the following:

3. Start selenium standalone server

1

$ java -jar selenium-server-standalone-2.47.0.jar

Keep this running in the background and open a new terminal window. Next step is to download WebdriverIO via NPM:

4. Download WebdriverIO

1

$ npm install webdriverio

5. Create a test file (test.js) with the following content

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

var webdriverio = require('webdriverio');
var options = {
    desiredCapabilities: {
        browserName: 'firefox'
    }
};
 
webdriverio
    .remote(options)
    .init()
    .url('http://www.google.com')
    .title(function(err, res) {
        console.log('Title was: ' + res.value);
    })
    .end();

6. Run your test file

1

$ node test.js

this should output the following:

1

Title was: Google