TypeScript icon, indicating that this package has built-in type declarations

8.32.3 • Public • Published

WebdriverIO Local Runner

A WebdriverIO runner to run tests locally within worker processes

The Local Runner initiates your framework (e.g. Mocha, Jasmine or Cucumber) within worker a process and runs all your test files within your Node.js environment. Every test file is being run in a separate worker process per capability allowing for maximum concurrency. Every worker process uses a single browser instance and therefore runs its own browser session allowing for maximum isolation.

Given every test is run in its own isolated process, it is not possible to share data across test files. There are two ways to work around this:

If nothing else is defined in the wdio.conf.js the Local Runner is the default runner in WebdriverIO.


To use the Local Runner you can install it via:

npm install --save-dev @wdio/local-runner


The Local Runner is the default runner in WebdriverIO so there is no need to define it within your wdio.conf.js. If you want to explicitly set it, you can define it as follows:

// wdio.conf.js
export const {
    // ...
    runner: 'local',
    // ...

For more information on WebdriverIO runner, check out the documentation.

Package Sidebar


npm i @wdio/local-runner

Weekly Downloads






Unpacked Size

33.6 kB

Total Files


Last publish


  • christian-bromann
  • wdio-user
  • wswebcreation-nl