# protractor

> Webdriver E2E test wrapper for Angular.

Latest version **7.0.0** (published 2020-05-13) · MIT license · 0 weekly downloads

> **Deprecated.** This package is deprecated.

## Install

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

Provides the commands `protractor`, `webdriver-manager`.

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 7.0.0 |
| Published | 2020-05-13 |
| First published | 2013-02-23 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >=10.13.x |
| Dependencies | 15 |
| Unpacked size | 697.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 8663 |
| Author | Julie Ralph |
| Maintainers | angular, angularcore, cnishina, google-wombot |
| Keywords | angular, test, testing, webdriver, webdriverjs, selenium |

## Links

- npm: https://www.npmjs.com/package/protractor
- Repository: https://github.com/angular/protractor
- Issues: https://github.com/angular/protractor/issues
- npm.io page: https://npm.io/package/protractor

## Dependencies (15)

- [q](https://npm.io/package/q.md) 1.4.1
- [glob](https://npm.io/package/glob.md) ^7.0.3
- [chalk](https://npm.io/package/chalk.md) ^1.1.3
- [yargs](https://npm.io/package/yargs.md) ^15.3.1
- [jasmine](https://npm.io/package/jasmine.md) 2.8.0
- [@types/q](https://npm.io/package/@types/q.md) ^0.0.32
- [saucelabs](https://npm.io/package/saucelabs.md) ^1.5.0
- [jasminewd2](https://npm.io/package/jasminewd2.md) ^2.1.0
- [browserstack](https://npm.io/package/browserstack.md) ^1.5.1
- [blocking-proxy](https://npm.io/package/blocking-proxy.md) ^1.0.0
- [webdriver-manager](https://npm.io/package/webdriver-manager.md) ^12.1.7
- [selenium-webdriver](https://npm.io/package/selenium-webdriver.md) 3.6.0
- [source-map-support](https://npm.io/package/source-map-support.md) ~0.4.0
- [webdriver-js-extender](https://npm.io/package/webdriver-js-extender.md) 2.1.0
- [@types/selenium-webdriver](https://npm.io/package/@types/selenium-webdriver.md) ^3.0.0

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

- 7.0.0 (latest) — 2020-05-13
- 5.4.4 — 2020-04-16
- 5.4.3 — 2020-01-28
- 6.0.0 — 2019-03-23
- 6.0.0-beta — 2018-12-25
- 5.4.2 — 2018-12-25
- 5.4.1 — 2018-09-10
- 5.4.0 — 2018-07-18
- 5.3.2 — 2018-05-10
- 5.3.1 — 2018-04-04
- 5.3.0 — 2018-01-25
- 5.2.2 — 2017-12-12
- 5.2.1 — 2017-12-07
- 5.2.0 — 2017-10-17
- 5.1.2 — 2017-05-15
- … 88 more at https://npm.io/package/protractor/versions

## README

Protractor [![Build Status](https://travis-ci.org/angular/protractor.svg?branch=master)](https://travis-ci.org/angular/protractor) [![CircleCI Status](https://circleci.com/gh/angular/protractor.svg?style=shield)](https://circleci.com/gh/angular/protractor) [![Join the chat at https://gitter.im/angular/protractor](https://badges.gitter.im/angular/protractor.svg)](https://gitter.im/angular/protractor)
==========

[Protractor](http://angular.github.io/protractor) is an end-to-end test framework for [Angular](http://angular.io/) and [AngularJS](http://angularjs.org) applications. Protractor is a [Node.js](http://nodejs.org/) program built on top of [WebDriverJS](https://github.com/SeleniumHQ/selenium/wiki/WebDriverJs). Protractor runs tests against your application running in a real browser, interacting with it as a user would.

Compatibility
-------------

Protractor 5 is compatible with nodejs v6 and newer.

Protractor works with AngularJS versions greater than 1.0.6/1.1.4, and is compatible with Angular applications. Note that for Angular apps, the `binding` and `model` locators are not supported. We recommend using `by.css`.


Getting Started
---------------
See the [Protractor Website](http://www.protractortest.org) for most documentation.

To get set up and running quickly:
 - Work through the [Tutorial](http://www.protractortest.org/#/tutorial)
 - See the [API](http://www.protractortest.org/#/api)

Once you are familiar with the tutorial, you’re ready to move on. To modify your environment, see the Protractor Setup docs. To start writing tests, see the Protractor Tests docs.

To better understand how Protractor works with the Selenium WebDriver and Selenium Server see the reference materials.


Getting Help
------------

Check the [Protractor FAQ](https://github.com/angular/protractor/blob/master/docs/faq.md) and read through the [Top 20 questions on StackOverflow](http://stackoverflow.com/questions/tagged/protractor?sort=votes&pageSize=20).

Please ask usage and debugging questions on [StackOverflow](http://stackoverflow.com/questions/tagged/protractor) (use the ["protractor"](http://stackoverflow.com/questions/ask?tags=protractor) tag), the [Gitter](https://gitter.im/angular/protractor) chat room, or in the [Angular discussion group](https://groups.google.com/forum/?fromgroups#!forum/angular). (Please do not ask support questions here on Github.)


For Contributors
----------------
See [DEVELOPER.md](https://github.com/angular/protractor/blob/master/DEVELOPER.md)

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