# @wdio/local-runner

> A WebdriverIO runner to run tests locally

Latest version **9.32.0** (published 2026-09-20) · MIT license · 0 weekly downloads

## Install

```sh
npm install @wdio/local-runner
pnpm add @wdio/local-runner
yarn add @wdio/local-runner
bun add @wdio/local-runner
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 9.32.0 |
| Published | 2026-09-20 |
| First published | 2018-11-06 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM |
| Node | >=18.20.0 |
| Dependencies | 10 |
| Unpacked size | 34 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 9835 |
| Author | Christian Bromann |
| Maintainers | christian-bromann, wdio-user, wswebcreation-nl |
| Keywords | webdriver, webdriverio, wdio, wdio-runner |

## Links

- npm: https://www.npmjs.com/package/@wdio/local-runner
- Repository: https://github.com/webdriverio/webdriverio
- Homepage: https://github.com/webdriverio/webdriverio/tree/main/packages/wdio-local-runner
- Issues: https://github.com/webdriverio/webdriverio/issues
- npm.io page: https://npm.io/package/@wdio/local-runner

## Dependencies (10)

- [split2](https://npm.io/package/split2.md) ^4.1.0
- [exit-hook](https://npm.io/package/exit-hook.md) ^4.0.0
- [@wdio/repl](https://npm.io/package/@wdio/repl.md) 9.16.2
- [@wdio/xvfb](https://npm.io/package/@wdio/xvfb.md) 9.32.0
- [@types/node](https://npm.io/package/@types/node.md) ^20.1.0
- [@wdio/types](https://npm.io/package/@wdio/types.md) 9.32.0
- [@wdio/logger](https://npm.io/package/@wdio/logger.md) 9.29.1
- [@wdio/runner](https://npm.io/package/@wdio/runner.md) 9.32.0
- [stream-buffers](https://npm.io/package/stream-buffers.md) ^3.0.2
- [expect-webdriverio](https://npm.io/package/expect-webdriverio.md) ^6.0.9

## Recent versions

- 9.32.0 (latest) — 2026-09-20
- 9.32.0-alpha.14 (next) — 2026-09-13
- 8.46.0 (v8) — 2025-08-11
- 7.40.0 (v7) — 2024-12-18
- 9.0.0-alpha.0 (v9) — 2024-03-12
- 7.0.0-beta.4 (beta) — 2021-02-09
- 5.23.0 (latest-5) — 2020-05-25
- 9.31.9 — 2026-09-13
- 9.32.0-alpha.13 — 2026-09-13
- 9.32.0-alpha.6 — 2026-09-13
- 9.32.0-alpha.0 — 2026-09-13
- 9.32.0-alpha.3 — 2026-09-13
- 9.31.8 — 2026-09-12
- 9.31.7 — 2026-09-07
- 9.31.6 — 2026-09-06
- … 714 more at https://npm.io/package/@wdio/local-runner/versions

## README

WebdriverIO Local Runner
========================

> A WebdriverIO runner to run tests locally within worker processes

The [Local Runner](https://www.npmjs.com/package/@wdio/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:

- use the [`@wdio/shared-store-service`](https://www.npmjs.com/package/@wdio/shared-store-service) to share data across all workers
- group spec files (read more in [Organizing Test Suite](https://webdriver.io/docs/organizingsuites#grouping-test-specs-to-run-sequentially))

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

## Install

To use the Local Runner you can install it via:

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

## Setup

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:

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

---

For more information on WebdriverIO runner, check out the [documentation](https://webdriver.io/docs/runner).

---
_Source: https://npm.io/package/@wdio/local-runner · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._