grunt plugin for starting Protractor's bundled Selenium Webdriver
npm install grunt-protractor-webdriver> grunt plugin for starting Protractor's bundled Selenium WebDriver
This Grunt task starts a Selenium WebDriver, blocks until it's ready to accept connections, and then leaves it running in the background until the Grunt process finished. During startup it checks for already running WebDriver instances and at the end of the Grunt process also shuts down the Selenium server to not leave you with any zombies.
grunt-protractor-webdriver is capable to handle parallelized tasks in case you use helpers like grunt-concurrent. That way you are able to work around the missing feature in Protractor that it's currently not able to run the tests against multiple browsers in parallel. See the Gruntfile.js for an example on how to do that.
This plugin requires Grunt ~0.4.0
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:
``shell`
npm install grunt-protractor-webdriver --save-dev
Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
`js`
grunt.loadNpmTasks('grunt-protractor-webdriver');
In your project's Gruntfile, add a section named protractor_webdriver to the data object passed into grunt.initConfig().
`js`
grunt.initConfig({
protractor_webdriver: {
options: {
// Task-specific options go here.
},
your_target: {
// Target-specific file lists and/or options go here.
},
},
});
#### options.command
Type: String
Default value:
Customize the way how the Selenium WebDriver is started. By default it assumes the presence of the webdriver-manager script (which comes bundled with Protractor) on the PATH.
#### options.path
Type: String
Default value:
Customize the path to the actual command that starts the the Selenium WebDriver. By default it assumes the presence of your script on the PATH.
#### options.keepAlive
Type: Boolean
Default value:
Whether or not to keep the Selenium server process alive when no more browser session are connected.
`js`
grunt.initConfig({
protractor_webdriver: {
your_target: {
options: {
path: '/path/to/',
command: 'custom-webdriver-manager start',
},
},
},
});
By default the output of the Selenium WebDriver is not being piped to the console by the protractor_webdriver task. In case you need detailed information about its state, just run your Grunt tasks with the --verbose flag.
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.
* v0.2.5 - Add support for Selenium Server >=v2.47. Fix for issues #17, #18 and #20.
* v0.2.0 - Possible breaking change for some, depending on the path configuration. Fix for issue #3. Always use node now to execute the webdriver_manager commands.keepAlive
* v0.1.9 - Use configuration option also in case of exception being thrown by the Selenium process. Alternative implementation for original PR #5.keepAlive
* v0.1.8 - Add support for new configuration option .Protractor
* v0.1.7 - Fix for issue #1. Print out a warning if Selenium server is not present. Additionally stop Selenium server gracefully on clean Grunt process shutdown.
* v0.1.6 - No code changes. Updated test showcase to use v.20.1..on('error')
* v0.1.5 - Unpublished due to wrong dependencies settings.
* v0.1.4 - No code changes. Just had to push new release as v0.1.3 seems to be lost in the NPM repo...
* v0.1.3 - Fix regression of v0.1.2 with wrong Selenium server path being used. Add additional exit handlers for , .on('uncaughtException') and .on('SIGINT').Selenium is already running` message on failure. Ensure waiting for all browser sessions to be deleted before shutdown.
* v0.1.2 - Harden waiting for all browser sessions to be deleted before shutdown. Due to possible race-conditions with log statements for multiple browser sessions in one line, the session counter didn't work properly.
* v0.1.1 - Ensure waiting for eventual
* v0.1.0 - Initial commit.
Copyright (c) 2014 Steffen Eckardt. Licensed under the MIT license.