# appium-webdriveragent

> Package bundling WebDriverAgent

Latest version **16.14.2** (published 2026-10-08) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install appium-webdriveragent
pnpm add appium-webdriveragent
yarn add appium-webdriveragent
bun add appium-webdriveragent
```

## Health

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

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

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 16.14.2 |
| Published | 2026-10-08 |
| First published | 2019-06-05 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | ^20.19.0 \|\| ^22.12.0 \|\| >=24.0.0 |
| Dependencies | 7 |
| Unpacked size | 2.7 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 1803 |
| Author | Appium Contributors |
| Maintainers | jlipps, nick.mokhnach, kazucocoa, eglitise, imurchie |
| Keywords | Appium, Selenium, WebDriver, WebDriverAgent, iOS |

## Links

- npm: https://www.npmjs.com/package/appium-webdriveragent
- Repository: https://github.com/appium/WebDriverAgent
- Homepage: https://github.com/appium/WebDriverAgent#readme
- Issues: https://github.com/appium/WebDriverAgent/issues
- npm.io page: https://npm.io/package/appium-webdriveragent

## Dependencies (7)

- [axios](https://npm.io/package/axios.md) ^1.18.0
- [asyncbox](https://npm.io/package/asyncbox.md) ^6.4.3
- [async-lock](https://npm.io/package/async-lock.md) ^1.0.0
- [teen_process](https://npm.io/package/teen_process.md) ^4.2.0
- [@appium/support](https://npm.io/package/@appium/support.md) ^7.2.6
- [@appium/strongbox](https://npm.io/package/@appium/strongbox.md) ^2.0.0
- [@appium/base-driver](https://npm.io/package/@appium/base-driver.md) ^10.8.0

## Alternatives

- [@snazzah/davey](https://npm.io/package/@snazzah/davey.md) — 1.5M weekly downloads
- [@vendure/testing](https://npm.io/package/@vendure/testing.md) — 8.3K weekly downloads
- [vue-simple-context-menu](https://npm.io/package/vue-simple-context-menu.md) — 6.6K weekly downloads
- [cypress-webpack-preprocessor-v5](https://npm.io/package/cypress-webpack-preprocessor-v5.md) — 2.1K weekly downloads
- [@backstage/plugin-catalog-backend-module-puppetdb](https://npm.io/package/@backstage/plugin-catalog-backend-module-puppetdb.md) — 1.3K weekly downloads

## Recent versions

- 16.14.2 (latest) — 2026-10-08
- 16.14.1 — 2026-10-07
- 16.14.0 — 2026-10-04
- 16.13.6 — 2026-09-30
- 16.13.5 — 2026-09-30
- 16.13.4 — 2026-09-30
- 16.13.3 — 2026-09-30
- 16.13.2 — 2026-09-30
- 16.13.1 — 2026-09-30
- 16.13.0 — 2026-09-30
- 16.12.11 — 2026-09-28
- 16.12.10 — 2026-09-21
- 16.12.9 — 2026-09-19
- 16.12.8 — 2026-09-11
- 16.12.7 — 2026-09-10
- … 491 more at https://npm.io/package/appium-webdriveragent/versions

## README

# WebDriverAgent

[![NPM version](http://img.shields.io/npm/v/appium-webdriveragent.svg)](https://npmjs.org/package/appium-webdriveragent)
[![Downloads](http://img.shields.io/npm/dm/appium-webdriveragent.svg)](https://npmjs.org/package/appium-webdriveragent)

[![Release](https://github.com/appium/WebDriverAgent/actions/workflows/publish.js.yml/badge.svg)](https://github.com/appium/WebDriverAgent/actions/workflows/publish.js.yml)

[![GitHub license](https://img.shields.io/badge/license-BSD-lightgrey.svg)](LICENSE)

WebDriverAgent is a [WebDriver server](https://w3c.github.io/webdriver/webdriver-spec.html) implementation for iOS that can be used to remote control iOS devices. It allows you to launch & kill applications, tap & scroll views or confirm view presence on a screen. This makes it a perfect tool for application end-to-end testing or general purpose device automation. It works by linking `XCTest.framework` and calling Apple's API to execute commands directly on a device. WebDriverAgent is developed for end-to-end testing and is successfully adopted by [Appium](http://appium.io) via [XCUITest driver](https://github.com/appium/appium-xcuitest-driver).

## Features
* Both iOS and tvOS platforms are supported with devices & simulators
* Implements most of [WebDriver Spec](https://w3c.github.io/webdriver/webdriver-spec.html)
* Implements part of [Mobile JSON Wire Protocol Spec](https://github.com/SeleniumHQ/mobile-spec/blob/master/spec-draft.md)
* USB support for devices is implemented via [appium-ios-device](https://github.com/appium/appium-ios-device) library and has zero dependencies on third-party tools.
* Easy development cycle as it can be launched & debugged directly via Xcode
* Use [Mac2Driver](https://github.com/appium/appium-mac2-driver) to automate macOS apps

## Getting Started On This Repository

You need to have Node.js installed for this project.

After it is finished you can simply open `WebDriverAgent.xcodeproj` and start `WebDriverAgentRunner` test
and start sending [requests](https://github.com/facebook/WebDriverAgent/wiki/Queries).

More about how to start WebDriverAgent [here](https://github.com/facebook/WebDriverAgent/wiki/Starting-WebDriverAgent).

## Multiple displays

See [Multiple displays](docs/multiple-displays.md) for display selection, capture,
and active-app detection.

See [Hinge angle](docs/hinge-angle.md) for reading angles, sending simulated hinge
events, runtime requirements, and physical-device testing feedback.

## Known Issues

If you are having some issues please checkout [wiki](https://github.com/facebook/WebDriverAgent/wiki/Common-Issues) first.

## For Contributors

If you want to help us out, you are more than welcome to. However please make sure you have followed the guidelines in [CONTRIBUTING](CONTRIBUTING.md).

## Creating Bundles

`npm run bundle`

Then, you find `WebDriverAgentRunner-Runner-sim-<version>.zip` for iOS and `WebDriverAgentRunner-Runner-tv_sim-<version>.zip` for tvOS files in the current directory.

## License

[`WebDriverAgent` is BSD-licensed](LICENSE).

Have fun!

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