gulp-angular-protractor

Gulp plugin to run protractor tests with automatic launch and stop of the WebDriver server

Install

1$ npm install --save-dev gulp-angular-protractor

Side dependencies

You should declare what expected version of protractor and webdriver manager you want to use:

1{
2  "name": "example-gulp-protractor",
3  "version": "0.0.1",
4  "description": "",
5  "scripts": {
6    "gulp": "node node_modules/gulp/bin/gulp.js",
7    "test": "npm run gulp protractor"
8  },
9  "devDependencies": {
10    "gulp": "latest",
11    "gulp-angular-protractor": "latest",
12    "protractor": "4.0.11",
13    "webdriver-manager": "10.2.8"
14  }
15}

Be carefull: some protractor and webdriver dependencies version required:

• Some specific node version
• Some specific npm version
• Some specific browser version
• ...

Usage

1var gulp = require('gulp');
2var angularProtractor = require('gulp-angular-protractor');
3
4gulp.src(['./src/tests/*.js'])
5	.pipe(angularProtractor({
6		'configFile': 'test/protractor.config.js',
7		'args': ['--baseUrl', 'http://127.0.0.1:8000'],
8		'autoStartStopServer': true,
9		'debug': true
10	}))
11	.on('error', function(e) { throw e })

Full example

1/*jshint node: true, camelcase: false*/
2/*global require: true*/

3
4'use strict';
5
6var gulp = require('gulp'),
7    gulpProtractorAngular = require('gulp-angular-protractor');
8
9// Setting up the test task
10gulp.task('protractor', function(callback) {
11    gulp
12        .src(['example_spec.js'])
13        .pipe(gulpProtractorAngular({
14            'configFile': 'protractor.conf.js',
15            'debug': false,
16            'autoStartStopServer': true
17        }))
18        .on('error', function(e) {
19            console.log(e);
20        })
21        .on('end', callback);
22});

API

angularProtractor(options)

options

options.autoStartStopServer

Type: Boolean Default: true

If true, the plugin will update the WebDriver, launch the WebDriver server before launching tests and stop it at the end automatically

options.configFile

Type: String Default: null

The path to your protractor config

options.args

Type: Array Default: []

Arguments get passed directly to the protractor call Read the docs for more information

options.debug

Type: Boolean Default: false

Enables Protractor's debug mode, which can be used to pause tests during execution and to view stack traces.

options.verbose

Type: Boolean Default: true

options.protractorModulePath

Type: String Default: undefined

If you want to use another protractor version instead the default one

options.webDriverUpdate

Type: Object Default: undefined

options.webDriverUpdate.skip

Type: Boolean Default: false

options.webDriverUpdate.browsers

Type: Array Default: ['chrome']

List of browsers to update the webdriver

options.webDriverUpdate.args

Type: Array Default: []

Additional arguments to pass for the update of the webdriver

options.webDriverStart

Type: Object Default: undefined

options.webDriverStart.args

Type: Array Default: []

Additional arguments to pass for the start of the webdriver

License

MIT © Julien Roche