# generic-webdriver-server

> A generic WebDriver server base class and a Selenium add-on to invoke it.

Latest version **1.1.5** (published 2023-09-11) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install generic-webdriver-server
pnpm add generic-webdriver-server
yarn add generic-webdriver-server
bun add generic-webdriver-server
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; large bundle.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.1.5 |
| Published | 2023-09-11 |
| First published | 2020-08-04 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 10.2 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Google |
| Maintainers | joeyparrish |
| Keywords | karma, selenium, webdriver |

## Links

- npm: https://www.npmjs.com/package/generic-webdriver-server
- Homepage: https://github.com/shaka-project/generic-webdriver-server
- npm.io page: https://npm.io/package/generic-webdriver-server

## Dependencies (2)

- [yargs](https://npm.io/package/yargs.md) ^17.4.0
- [express](https://npm.io/package/express.md) ^4.17.3

## 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

- 1.1.5 (latest) — 2023-09-11
- 1.1.4 — 2022-03-30
- 1.1.3 — 2022-02-07
- 1.1.2 — 2021-04-01
- 1.1.1 — 2021-02-20
- 1.1.0 — 2020-12-22
- 1.0.4 — 2020-08-04
- 1.0.3 — 2020-08-04
- 1.0.2 — 2020-08-04
- 1.0.1 — 2020-08-04
- 1.0.0 — 2020-08-04

## README

# Generic WebDriver Server

A generic [WebDriver][] server framework and base class, implementing the subset
of the WebDriver protocol necessary for [Karma][].

 - Automate JavaScript tests on exotic devices!
 - Easily add new devices!
 - Integrate easily with [Selenium grid][]!
 - Written for NodeJS and distributed via NPM!


## Intended audience

 - Projects using something like [Karma][] for testing with a [Selenium grid][]
   - If your test runner uses [WebDriver][] to point browsers back to a URL,
     this subset of the [WebDriver][] protocol can expand your grid to new
     devices
 - Not for testing via [WebDriver][] directly
   - If you use a [WebDriver][] client directly in your tests, this probably
     won't help you
   - Does not support element interaction or script injection
   - Screenshots may be supported on certain platforms


## Basic requirements

 - [NodeJS 8+](https://nodejs.org/)
 - [Selenium 3](https://www.selenium.dev/) (included)
 - [Java](https://openjdk.java.net/) (to run Selenium)


## What devices are supported?

Out of the box, we provide backends for:
 - Chromecast (NPM package [`chromecast-webdriver-server`](https://www.npmjs.com/package/chromecast-webdriver-server))
 - ChromeOS (NPM package [`chromeos-webdriver-server`](https://www.npmjs.com/package/chromeos-webdriver-server))
 - Tizen (NPM package [`tizen-webdriver-server`](https://www.npmjs.com/package/tizen-webdriver-server))
 - Xbox One/One X/One S/Series X/Series S (NPM package [`xbox-one-webdriver-server`](https://www.npmjs.com/package/xbox-one-webdriver-server))

In addition, you'll need JAR files from the package [`generic-webdriver-server`](https://www.npmjs.com/package/generic-webdriver-server).


## Chromium-based Edge

In addition to the backends we provide, you can also use this generic backend to
support Chromium-based Edge in Selenium 3, in spite of [Selenium's recent
decision not to support it directly.](https://github.com/SeleniumHQ/selenium/issues/8237#issuecomment-629851734)
For details on setup for Chromium-based Edge, see [Edgium.md](https://github.com/shaka-project/generic-webdriver-server/blob/main/Edgium.md)


## How it works

See [how-it-works.md](https://github.com/shaka-project/generic-webdriver-server/blob/main/how-it-works.md)
for details.


## Setup

See [setup.md](https://github.com/shaka-project/generic-webdriver-server/blob/main/setup.md)
for details.


[Karma]: https://karma-runner.github.io/
[Selenium grid]: https://www.selenium.dev/documentation/en/grid/
[WebDriver]: https://www.w3.org/TR/webdriver2/

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