Skip to content
E2E test framework for Angular apps http://www.protractortest.org
JavaScript HTML Other
Failed to load latest commit information.
bin chore(cleanup): Replaced Array#forEach with more suitable method: som…
debugging chore(jasmine): remove jasmine 1.3
docs chore(docs): Updated afterLaunch method documentation in referenceCon…
example chore(jasmine): remove jasmine 1.3
lib cleanup(lodash): remove lodash dependency
scripts fix(tests): fix error tests after testapp api slight rename
spec chore(ci): bump to latest 2 versions of ie, chrome, safari
stress chore(jasmine): remove jasmine 1.3
testapp chore(plugins): Split first party plugins into seperate repos
website chore(docs): include `webdriver.Key` and `webdriver.promise` in API page
.gitattributes chore(eol): normalize all the line endings
.gitignore chore(npm/github): update ignore files
.jshintrc chore(style): Add "curly" rule to jshintrc
.npmignore chore(npm/github): update ignore files
.travis.yml feat(driver providers): Add BrowserStack support.
CHANGELOG.md chore(docs): Fixed typo - getMultiCapabilities promise is resolved after
CONTRIBUTING.md docs(contributing): mention the test application
LICENSE chore(license): Update copyright year range
README.md bug(driverProvider): fix driver path generation for *nix platforms
config.json chore(deps): bump chromedriver and iedriver versions
package.json cleanup(lodash): remove lodash dependency
release.md chore(release): Add steps for website.

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
Something went wrong with that request. Please try again.