grunt-mocha-protractor

Run e2e angular tests with webdriver.

Getting Started

This plugin requires Grunt ~0.4.1

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

1npm install grunt-mocha-protractor --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

1grunt.loadNpmTasks('grunt-mocha-protractor');

The "mochaProtractor" task

Overview

Currently you will need to have the Selenium Server running in the default location on localhost.

In your project's Gruntfile, add a section named mochaProtractor to the data object passed into grunt.initConfig().

1grunt.initConfig({
2  mochaProtractor: {
3    options: {
4      browsers: ['Chrome', 'Firefox']
5    },
6    files: ['test/*.js']
7  },
8})

Options

The usual Mocha options are passed through this task to the new Mocha instance.

options.browsers

Type: Array Default value: ['Chrome']

List of browsers to test with.

To test with SauceLabs the browser can also be specified as an object.

1grunt.initConfig({
2  mochaProtractor: {
3    options: {
4      reporter: 'Spec',
5      browsers: [{
6        base: 'SauceLabs',
7        browserName: 'Firefox',
8        platform: 'Windows 7',
9        version: '23'
10      }]
11    },
12    files: ['test/*.js']
13  },

options.reporter

Type: String Default value: Spec

Mocha reporter to use

options.baseUrl

Type: String Default value: ``

options.args

Type: Array Default value: null

Example of full config

1grunt.initConfig({
2  mochaProtractor: {
3    options: {
4      browsers: ['Chrome', 'Firefox'],
5      reporter: 'Spec',
6      baseUrl: 'https://develop.mywebsite.local',
7      args: '--ignore-certificate-errors',
8      timeout: 10000, // in milliseconds
9      suiteTimeout: 90000 // in milliseconds
10    },
11    files: ['test/*.js']
12  },
13})

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

Release History

• v0.5.2 - update dependencies.
• v0.5.1 - add ability to override timeouts (thanks chriscantu).
• v0.5.0 - add seleniumUrl param, fixed "max call stack" error (thanks nowells).
• v0.4.0 - added protractor globals.
• v0.3.2 - add rootElement and params options (thanks AdamQuadmon).
• v0.3.1 - update dependencies.
• v0.3.0 - better error handling.
• v0.2.0 - added saucelabs support.
• v0.1.0 - initial release.