grunt-selenium-standalone

Grunt tasks for running a standalone Selenium server using the popular selenium-standalone package

Usage no npm install needed!

<script type="module">
  import gruntSeleniumStandalone from 'https://cdn.skypack.dev/grunt-selenium-standalone';
</script>

README

grunt-selenium-standalone

Grunt tasks for running a standalone Selenium server using the popular selenium-standalone package

Getting Started

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:

npm install grunt-selenium-standalone --save-dev

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

grunt.loadNpmTasks('grunt-selenium-standalone');

The "selenium_standalone" task

Configuration overview

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

grunt.initConfig({
  selenium_standalone: {
    options: {
      stopOnExit: true
    }
    your_target: {
      seleniumVersion: '2.53.0',
      seleniumDownloadURL: 'http://selenium-release.storage.googleapis.com',
      drivers: {
        chrome: {
          version: '2.21',
          arch: process.arch,
          baseURL: 'http://chromedriver.storage.googleapis.com'
        },
        ie: {
          version: '2.53.0',
          arch: 'ia32',
          baseURL: 'http://selenium-release.storage.googleapis.com'
        }
      }
    }
  }
});

Command Verbs

For each target of the task selenium_standalone you can issue multiple commands with command verbs. The supported command verbs are:

  • install: installs the web drivers which were specified for a given target
  • start: starts the selenium server
  • stop: stops the selenium server

Options

stopOnExit

For each target, you can specify if the selenium server should stop automatically when the executing Grunt task run completes or fails. The default is false.

Contributing

Run tests

grunt test

Release History

  • 1.0.1: Fixed an issue with passing the seleniumDownloadURL config property through
  • 1.0.0: Updates to better support option pass-through to the underlying selenium-standalone module
  • 0.1.0: initial implementation. Commands: install, start, stop are implemented.