Improve this doc

Selenium Standalone Service

Handling the Selenium server is out of scope of the actual WebdriverIO project. This service helps you to run Selenium seamlessly when running tests with the WDIO testrunner. It uses the well known selenium-standalone NPM package that automatically sets up the standalone server and all required drivers for you.

Installation

The easiest way is to keep wdio-selenium-standalone-service as a devDependency in your package.json.

1
2
3
4
5
{
"devDependencies": {
"wdio-selenium-standalone-service": "~0.1"
}
}

You can simple do it by:

1
npm install wdio-selenium-standalone-service --save-dev

Instructions on how to install WebdriverIO can be found here.

Configuration

By default, Google Chrome, Firefox and PhantomJS are available when installed on the host system. In order to use the service you need to add selenium-standalone to your service array:

1
2
3
4
5
6
7
8
9
// wdio.conf.js
exports.config = {
// ...
services: ['selenium-standalone'],
// ...
// Options are set here as well
seleniumLogs: './logs',
//...
};

Options

seleniumLogs

Path where all logs from the Selenium server should be stored.

Type: String

seleniumArgs

Object configuration for selenium-standalone.start().

Type: Object
Default: {}

seleniumInstallArgs

Object configuration for selenium-standalone.install().

Type: Object
Default: {}