E2E test framework for Angular apps
Switch branches/tags
Clone or download
Pull request Compare This branch is 534 commits behind angular:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin chore(cleanup): Replaced Array#forEach with more suitable method: som… Nov 9, 2015
debugging chore(jasmine): remove jasmine 1.3 Nov 3, 2015
docs fix(config): fix environmentOverrides to disableEnvironmentOverrides Jan 22, 2016
example chore(jasmine): remove jasmine 1.3 Nov 3, 2015
lib fix(config): fix environmentOverrides to disableEnvironmentOverrides Jan 22, 2016
scripts chore(test): angular2 testapp Jan 25, 2016
spec chore(test): angular2 testapp Jan 25, 2016
stress chore(jasmine): remove jasmine 1.3 Nov 3, 2015
testapp chore(test): angular2 testapp Jan 25, 2016
website chore(testapp): section off angular 1 testapp Jan 14, 2016
.gitattributes chore(eol): normalize all the line endings Sep 29, 2014
.gitignore chore(npm/github): update ignore files Nov 16, 2015
.jshintrc chore(style): Add "curly" rule to jshintrc Dec 22, 2015
.npmignore chore(npm/github): update ignore files Nov 16, 2015
.travis.yml chore(ci): Install g++ 4.8 on Travis to prevent compilation errors Jan 22, 2016
CHANGELOG.md chore(docs): Fixed typo - getMultiCapabilities promise is resolved after Dec 28, 2015
CONTRIBUTING.md docs(contributing): mention the test application Nov 18, 2015
LICENSE chore(license): Update copyright year range Jan 9, 2015
README.md bug(driverProvider): fix driver path generation for *nix platforms Dec 22, 2015
config.json chore(deps): bump chromedriver and iedriver versions Nov 17, 2015
package.json chore(deps): update various npm dependencies to latest stable releases Jan 22, 2016
release.md chore(release): Add steps for website. Dec 26, 2014

README.md

Protractor Build Status Join the chat at https://gitter.im/angular/protractor

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.

Compatibility

Protractor 3 is compatible with nodejs v4 and newer.

When using nodejs v0.12, use protractor 2 (npm install -g protractor@2).

Getting Started

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

To get set up and running quickly:

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), the Gitter chat room, or in the Angular discussion group. (Please do not ask support questions here on Github.)

For Contributors

Clone the github repository:

git clone https://github.com/angular/protractor.git
cd protractor
npm install
./bin/webdriver-manager update
cd website
npm install
cd ..

Start up a selenium server. By default, the tests expect the selenium server to be running at http://localhost:4444/wd/hub. A selenium server can be started with webdriver-manager.

bin/webdriver-manager start

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

npm start

Then run the tests with

npm test