Debugging

Debugging is significantly more difficult when there are several processes spawning dozens of tests in multiple browsers.

For starters, it is extremely helpful to limit parallelism by setting maxInstances to 1 and targeting only those specs and browsers that need to be debugged.

In wdio.conf:

1
2
3

maxInstances: 1,
specs: ['**/myspec.spec.js'],
capabilities: [{browserName: 'firefox'}]

In many cases, you can use browser.debug() to pause your test and inspect the browser. Your command line interface will also switch into a REPL mode that allows you to fiddle around with commands and elements on the page. In REPL mode you can access the browser object or $ and $$ functions like you can in your tests.

When using browser.debug() you will likely need to increase the timeout of the test runner to prevent the test runner from failing the test for taking to long. For example:

In wdio.conf:

1
2
3

jasmineNodeOpts: {
  defaultTimeoutInterval: (24 * 60 * 60 * 1000);
}

See timeouts for more information on how to do that using other frameworks.

Watch files

With v4.6.0 WebdriverIO introduced a watch argument that can help you to run certain specs when they get updated. To enable it just run the wdio command with the watch flag like:

1

wdio wdio.conf.js --watch

It will initialize the desired Selenium sessions defined in your config and will wait until a file that was defined via the specs option has changed. This works regardless you run your tests on a local grid or on cloud services like SauceLabs.

Node Inspector

For a more comprehensive debugging experience you can enable debug flag to start the test runner processes with an open debugger port.

This will allow attaching the node-inspector and pausing test execution with debugger. Each child process will be assigned a new debugging port starting at 5859.

This feature can be enabled by enabling the debug flag in wdio.conf:

1
2
3

{
  debug: true
}

Once enabled tests will pause at debugger statements. You then must attach the debugger to continue.

If you do not already have node-inspector installed, install it with:

1

npm install -g node-inspector

And attach to the process with:

1

node-inspector --debug-port 5859 --no-preload

The no-preload option defers loading source file until needed, this helps performance significantly when project contains a large number of node_modules, but you may need to remove this if you need to navigate your source and add additional breakpoints after attaching the debugger.

Dynamic configuration

Note that wdio.conf can contain javascript. Since you probably do not want to permanently change your timeout value to 1 day, it can be often helpful to change these settings from the command line using an environment variable. This can used to dynamically change the configuration:

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

var debug = process.env.DEBUG;
var defaultCapabilities = ...;
var defaultTimeoutInterval = ...;
var defaultSpecs = ...;


exports.config = {
debug: debug,
maxInstances: debug ? 1 : 100,
capabilities: debug ? [{browserName: 'chrome'}] : defaultCapabilities,
specs:  process.env.SPEC ? [process.env.SPEC] : defaultSepcs,
jasmineNodeOpts: {
  defaultTimeoutInterval: debug ? (24 * 60 * 60 * 1000) : defaultTimeoutInterval
}

You can then prefix the wdio command with your desired values:

1

DEBUG=true SPEC=myspec ./node_modules/.bin/wdio wdio.conf

Dynamic Repl with Atom

If you are an Atom hacker you can try wdio-repl by @kurtharriger which is a dynamic repl that allows you to execute single code lines in Atom. Watch this Youtube video to see a demo.