Protractor CI
Warning
This project is alpha status. Use at your own risk.
Goals
- Run E2E tests against all target browsers.
- Run E2E tests on Travis CI.
- Mock requests to external APIs (semi-automatically).
Installation
npm install protractor-ci --save-dev
Workflow
-
Run E2E tests against locally against live dev API This step records all external API requests for later playback.
-
Verify test playback Uses the recorded mock requests from step 1.
-
Run E2E tests against Sauce Labs Uses the recorded mock requests from step 1.
-
Run E2E tests on Travis CI on deployment Uses the recorded mock requests from step 1.
Run Local E2E Tests
Define the task:
var pXor = ; gulp;
Run the task:
gulp test:e2e:record
Playback E2E Tests
Define the task:
var pXor = ; gulp;
Run the task:
gulp test:e2e:playback
Playback E2E Tests using SauceLabs
var pXor = ; // define task to start sauce connectgulp; // define test runnergulp;
Now open two terminal windows.
In the first terminal:
gulp start-sauce-connect
Leave the terminal open. The task will let you know when it's ready to start the tests.
In the second terminal:
gulp test:e2e:ci
Travis CI Setup
First follow these instructions.
Next, make sure the before_install
and addons
blocks exist in your .travis.yml
file:
language: node_jsnode_js:- 'x.xx' env: global: - secure: xxx - secure: yyy - NODE_ENV=travis addons: sauce_connect: true cache: directories: - node_modules before_install:- npm install- node_modules/.bin/bower install --config.directory=path/to/test/server
The goal is to ensure that the dev server has everything it needs to be run by Travis. More steps may be required depending on your application.
Then, in your package.json
file:
// ... "scripts": "test": "gulp test:e2e:ci" // ...