# wp-e2e-webdriver

> Webdriver manager and helper for WP end-to-end tests

Latest version **0.16.1** (published 2020-04-10) · GPL-2.0 license · 0 weekly downloads

## Install

```sh
npm install wp-e2e-webdriver
pnpm add wp-e2e-webdriver
yarn add wp-e2e-webdriver
bun add wp-e2e-webdriver
```

## Health

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

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.16.1 |
| Published | 2020-04-10 |
| First published | 2016-12-04 |
| Weekly downloads | 0 |
| License | GPL-2.0 |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 7 |
| Unpacked size | 374.5 KB |
| Known vulnerabilities | 0 (+1 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 5 |
| Author | WooCommerce |
| Maintainers | bgrgicak, gedex, rodrigoprimo |
| Keywords | WordPress, wp, e2e, selenium, webdriver |

## Links

- npm: https://www.npmjs.com/package/wp-e2e-webdriver
- Repository: https://github.com/woocommerce/wp-e2e-webdriver
- Issues: https://github.com/woocommerce/wp-e2e-webdriver/issues
- npm.io page: https://npm.io/package/wp-e2e-webdriver

## Dependencies (7)

- [temp](https://npm.io/package/temp.md) ^0.9.1
- [slugs](https://npm.io/package/slugs.md) ^0.1.3
- [fs-extra](https://npm.io/package/fs-extra.md) ^8.1.0
- [url-join](https://npm.io/package/url-join.md) ^4.0.1
- [saucelabs](https://npm.io/package/saucelabs.md) ^3.0.1
- [chromedriver](https://npm.io/package/chromedriver.md) ^80.0.0
- [selenium-webdriver](https://npm.io/package/selenium-webdriver.md) 3.6.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

- 0.16.1 (latest) — 2020-04-10
- 0.16.0 — 2019-12-18
- 0.15.0 — 2018-05-10
- 0.14.0 — 2018-04-10
- 0.13.0 — 2017-11-08
- 0.12.0 — 2017-11-07
- 0.11.0 — 2017-03-17
- 0.10.0 — 2017-02-20
- 0.9.1 — 2016-12-17
- 0.9.0 — 2016-12-15
- 0.8.1 — 2016-12-14
- 0.8.0 — 2016-12-13
- 0.7.0 — 2016-12-05
- 0.6.0 — 2016-12-05
- 0.5.0 — 2016-12-05
- … 4 more at https://npm.io/package/wp-e2e-webdriver/versions

## README

wp-e2e-webdriver
================

[![npm version](https://img.shields.io/npm/v/wp-e2e-webdriver.svg?style=flat)](https://www.npmjs.com/package/wp-e2e-webdriver)
[![build status](https://api.travis-ci.org/woocommerce/wp-e2e-webdriver.svg)](http://travis-ci.org/woocommerce/wp-e2e-webdriver)
[![dependency status](https://david-dm.org/woocommerce/wp-e2e-webdriver.svg)](https://david-dm.org/woocommerce/wp-e2e-webdriver)

Webdriver manager and helper for WordPress. Most of the good stuff were shamelessly
copied from [wp-e2e-tests](https://github.com/Automattic/wp-e2e-tests). Thanks to
wp-e2e-tests authors and contributors for providing the foundation!

This package provides WebDriver manager and helper to help you test WordPress
site.

By default, this package uses [chromedriver](https://sites.google.com/a/chromium.org/chromedriver/),
but you can optionally install other drivers such as [geckodriver](https://github.com/mozilla/geckodriver)
or use remote webdriver via [Sauce Labs](https://saucelabs.com/).

## Install

```
npm install wp-e2e-webdriver
```

## Usage

~~~js
import { By } from 'selenium-webdriver';
import { WebDriverManager, WebDriverHelper as helper } from 'wp-e2e-webdriver'

const manager = new WebDriverManager( 'chrome' );
const driver = manager.getDriver();

driver.get( 'https://automattic.com/work-with-us/' );
helper.waitTillPresentAndDisplayed(
	driver,
	By.css( '#content' )
);
~~~

## Docs

* [Tutorials](https://woocommerce.github.io/wp-e2e-webdriver/wp-e2e-webdriver/0.16.0/tutorial-overview.html)
* [API docs](https://woocommerce.github.io/wp-e2e-webdriver/wp-e2e-webdriver/0.16.0/)
* [Contributing](./.github/CONTRIBUTING.md)

## Dependents

The reason we pulled out manager and helper from wp-e2e-tests so that following
dependents can use that:

* [wp-e2e-page-objects](https://github.com/woocommerce/wp-e2e-page-objects) — Repo will be published later. WordPress Page Objects
  package
* [wc-e2e-page-objects](https://github.com/woocommerce/wc-e2e-page-objects) — WooCommerce Page Objects package
* WordPress plugin or WooCommerce extensions that will have e2e tests that use wp-e2e-page-objects or wc-e2e-page-objects.

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