# webdriverio

> Next-gen browser and mobile automation test framework for Node.js

Latest version **9.31.9** (published 2026-09-13) · MIT license · 0 weekly downloads

## Install

```sh
npm install webdriverio
pnpm add webdriverio
yarn add webdriverio
bun add webdriverio
```

## Health

**Score 58/100 (C)** — status: active.

Positive: has types package; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 9.31.9 |
| Published | 2026-09-13 |
| First published | 2014-08-11 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | separate (@types/webdriverio) |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 9835 |
| Author | Christian Bromann |
| Maintainers | christian-bromann, wdio-user, wswebcreation-nl |
| Keywords | webdriverio, webdriver, selenium, appium, saucelabs, sauce, labs, mocha, nodeUnit, buster, puppeteer, vows, jasmine, assert, cucumber, testingbot |

## Links

- npm: https://www.npmjs.com/package/webdriverio
- Repository: https://github.com/webdriverio/webdriverio
- Homepage: https://webdriver.io
- Issues: https://github.com/webdriverio/webdriverio/issues
- npm.io page: https://npm.io/package/webdriverio

## Alternatives

- [duck](https://npm.io/package/duck.md) — 4.2M weekly downloads
- [ava](https://npm.io/package/ava.md) — 560.2K weekly downloads
- [storybook-addon-module-mock](https://npm.io/package/storybook-addon-module-mock.md) — 71.7K weekly downloads
- [vest](https://npm.io/package/vest.md) — 50.1K weekly downloads
- [@ethereum-waffle/mock-contract](https://npm.io/package/@ethereum-waffle/mock-contract.md) — 40.0K weekly downloads

## Recent versions

- 9.31.9 (latest) — 2026-09-13
- 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
- 5.0.0-alpha.14 (alpha) — 2018-08-08
- 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
- … 805 more at https://npm.io/package/webdriverio/versions

## README

WebdriverIO
===========

> Next-gen browser and mobile automation test framework for Node.js

This package provides an easy-to-manage API and a lot of syntactical sugar on top of the WebDriver specification. You can use WebdriverIO as a standalone package or via a test runner using [`@wdio/cli`](https://webdriver.io/docs/clioptions). WebdriverIO allows you to run tests locally using the WebDriver as well as remote user agents using cloud providers like [Sauce Labs](https://saucelabs.com/).

## Installation

You can install WebdriverIO via NPM:

```sh
npm install webdriverio
```

## Usage

WebdriverIO by default uses Puppeteer to automate a browser like Chrome, Firefox or Chromium Edge. So if you have Chrome installed, the following script should start a browser for you and get the title of the page:

```js
import { remote } from 'webdriverio'

const browser = await remote({
    capabilities: { browserName: 'chrome' }
})

await browser.navigateTo('https://www.google.com/ncr')

const searchInput = await browser.$('#lst-ib')
await searchInput.setValue('WebdriverIO')

const searchBtn = await browser.$('input[value="Google Search"]')
await searchBtn.click()

console.log(await browser.getTitle()) // outputs "WebdriverIO - Google Search"

await browser.deleteSession()
```

See the raw [protocol example](https://www.npmjs.com/package/webdriver#example) using the `webdriver` package to get a glance at the differences.

For more information on [options](https://webdriver.io/docs/options#webdriver-options), [multiremote usage](https://webdriver.io/docs/multiremote) or integration into [cloud services](https://webdriver.io/docs/cloudservices) please check out the [docs](https://webdriver.io/docs/gettingstarted).

---

<center>Package Sponsors:</center>
<p align="center">
    <a href="https://www.browserstack.com/automation-webdriverio">
        <img src="https://webdriver.io/img/sponsors/browserstack_black.svg" alt="BrowserStack" width="300" />
    </a>
    &nbsp;
    <a href="https://momentic.ai/">
        <img src="https://webdriver.io/img/sponsors/momentic_black.svg" alt="Momentic" width="300" />
    </a>
</p>

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