protractor 0 travis-ci npm

E2E test framework for Angular apps

Protractor Build Status

Protractor is an end-to-end test framework for AngularJS applications. Protractor is a Node.js program built on top of WebDriverJS. Protractor runs tests against your application running in a real browser, interacting with it as a user would.

Getting Started

The Protractor documentation for users is located in the protractor/docs folder.

To get set up and running quickly: - The Protractor Website - Work through the Tutorial - Take a look at the Table of Contents

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 and read through the Top 20 questions on StackOverflow.

Please ask usage and debugging questions on StackOverflow (use the “protractor” tag) or in the Angular discussion group. (Please do not ask support questions here on Github.)

For Contributors

Clone the github repository:

git clone
cd protractor
npm install

Start up a selenium server. By default, the tests expect the selenium server to be running at http://localhost:4444/wd/hub.

Protractor’s test suite runs against the included test application. Start that up with

npm start

Then run the tests with

npm test

Related Repositories



⭕ A step-by-step guide presentation on Protractor end-to-end testing ...



A library designed to work alongside Protractor for setting up mocks for your HTTP ajax requests. ...



gulp wrapper for protractor tests ...



The .NET port of Protractor, an E2E test framework for Angular apps ...



A Vagrant VM providing Protractor, Selenium standalone server, and Xvfb for headless browser end to end testing of AngularJS applications. ...

Top Contributors

juliemr hankduan sjelin andresdominguez el-davo elgalu eddiemonge chirayuk DavidMikeSimon alecxe kayhadrin jeffbcross davemo bcaudan jnizet eduardomb bclinkinbeard jfroom JLLeitschuh groner thetoothpick wlingke luismreis wiggzz owenmead philippd tombatossals stevemao shelbyd keoghpe


-   2.1.0 zip tar
-   2.0.0 zip tar
-   1.8.0 zip tar
-   1.7.0 zip tar
-   1.6.1 zip tar
-   1.6.0 zip tar
-   1.5.0 zip tar
-   1.4.0 zip tar
-   1.3.1 zip tar
-   1.3.0 zip tar
-   1.2.0 zip tar
-   1.1.1 zip tar
-   1.1.0 zip tar
-   1.0.0 zip tar
-   1.0.0-rc6 zip tar
-   1.0.0-rc5 zip tar
-   1.0.0-rc4 zip tar
-   1.0.0-rc3 zip tar
-   1.0.0-rc2 zip tar
-   1.0.0-rc1 zip tar
-   0.24.2 zip tar
-   0.24.1 zip tar
-   0.24.0 zip tar
-   0.23.1 zip tar
-   0.23.0 zip tar
-   0.22.0 zip tar
-   0.21.0 zip tar
-   0.20.1 zip tar
-   0.20.0 zip tar
-   0.19.0 zip tar