Edit

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 know selenium-standalone NPM package that automatically sets up the standalone server and all required driver for you.

Installation

Before starting make sure you have JDK installed.

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

{
    "devDependencies": {
        "@wdio/selenium-standalone-service": "^5.0.0"
    }
}

You can simple do it by:

npm install @wdio/selenium-standalone-service --save-dev

Instructions on how to install WebdriverIO can be found here.

Configuration

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

// wdio.conf.js
export.config = {
    // ...
    services: [
        ['selenium-standalone', {
            logPath: 'logs',
            installArgs: {
                drivers: {
                    chrome: { version: '79.0.3945.88' },
                    firefox: { version: '0.26.0' }
                }
            },
            args: {
                drivers: {
                    chrome: { version: '79.0.3945.88' },
                    firefox: { version: '0.26.0' }
                }
            },
        }]
    ],
    // ...
};

Options

The following options can be added to the wdio.conf.js file.

logPath

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

Type: String

Default: {}

Example:

logPath : './',

args

Map of arguments for the Selenium server, passed directly to Selenium.start(). Please note that latest drivers have to be installed, see installArgs.

Type: Object

Default: {}

Example:

args: {
    version : "3.141.59",
    drivers : {
        chrome : {
            version : "79.0.3945.88",
            arch    : process.arch,
        }
    }
},

installArgs

Map of arguments for the Selenium server, passed directly to Selenium.install().

By default, versions will be installed based on what is set in the selenium-standalone package. The defaults can be overridden by specifying the versions.

Type: Object

Default: {}

Example:

installArgs: {
    version : "3.141.59",
    baseURL : "https://selenium-release.storage.googleapis.com",
    drivers : {
        chrome : {
            version : "77.0.3865.40",
            arch    : process.arch,
            baseURL : "https://chromedriver.storage.googleapis.com",
        }
    }
},

skipSeleniumInstall

Boolean for skipping selenium-standalone server install.

Type: Boolean

Default: false

---

For more information on WebdriverIO see the homepage.