Crossbrowsertesting Service

A WebdriverIO service that manages local tunnel and job metadata for CrossBrowserTesting users.


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

"devDependencies": {
"@wdio/crossbrowsertesting-service": "^6.1.14"

Or simply run:

npm install @wdio/crossbrowsertesting-service --save-dev

Instructions on how to install WebdriverIO can be found here.


In order to use the service you need to set user and key in your wdio.conf.js file, and set the host option to If you want to use CrossBrowserTesting Tunnel you just need to set cbtTunnel: true.

// wdio.conf.js
export.config = {
// ...
user: process.env.CBT_USERNAME,
key: process.env.CBT_AUTHKEY,
services: [
['crossbrowsertesting', {
cbtTunnel: true,
cbtTunnelOpts: {
// any additional options from cbt_tunnels
// ...


In order to authorize to the CrossBrowserTesting service your config needs to contain a user and key option.


If true secure CBT local connection is started.

Type: Boolean
Default: false


Any additional options to pass along to the start() function of cbt_tunnels

Type: Object
Default: {}

For more information on WebdriverIO see the homepage.