Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Grunt plugin for Selenium Web Driver using html suite
branch: master
Failed to load latest commit information.

Grunt Selenium

Build Status

Execute WebDriver using HTML suite file which is Selenium IDE general formatted.

  • Selenium IDE can debug easily more than WebDriver.
  • WebDriver can test on browsers not only Firefox and detect browser depended bugs.


  • Execute WebDriver using HTML multiple suite files
  • Enclose IEDriver, ChromeDriver
  • Save HTML source when open command executed.

Getting Started

Install Grunt

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 --save-dev

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


Install node-gyp, when you use Windows

See below and install node-gyp

Prepare for using IE, when you use Windows

  • Open Internet options on IE
  • Check Safe mode on all site type

The "selenium" task


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

  selenium: {
    options: {
      browsers: ['firefox','ie','chrome']
    suite: {
      files: {
        'example.tap': ['test/source/**/*.suite']

Files property

  • src HTML test suite file path or HTML test case file path.
  • dist TAP file path



Type: String Default value: undefined

Execute selenium with this URL.


Type: Array Default value: [ 'firefox' ]

Array value that is used to testing browsers.


Type: Number Default value: 10000

Command timeout.


Type: String Default value: undefined

The path to save html source, when execute open command.


Type: Proxy Object Default value: undefined

A JSON object describing a Proxy configuration

Supported Selenium IDE commands

  • assertAlert
    • assertAttribute
    • assertChecked
    • assertCookieByName
    • assertEditable
    • assertElementNotPresent
    • assertElementPresent
    • assertEval
    • assertExpression
    • assertLocation
    • assertNotChecked
    • assertNotEditable
    • assertText
    • assertTextNotPresent
    • assertTextPresent
    • assertTitle
    • assertValue
    • captureEntirePageScreenshot
    • captureEntirePageScreenshotAndWait
    • check
    • checkAndWait
    • click
    • clickAndWait
    • createCookie
    • createCookieAndWait
    • deleteCookie
    • deleteCookieAndWait
    • echo
    • echoAndWait
    • fireEvent
    • fireEventAndWait
    • getEval
    • getEvalAndWait
    • goBack
    • goBackAndWait
    • open
    • openAndWait
    • refresh
    • refreshAndWait
    • select
    • selectAndWait
    • selectFrame
    • selectFrameAndWait
    • sendKeys
    • sendKeysAndWait
    • store
    • storeChecked
    • storeCookieByName
    • storeElementPresent
    • storeEval
    • storeText
    • type
    • typeAndWait
    • uncheck
    • uncheckAndWait
    • verifyAttribute
    • verifyCookieByName
    • verifyEditable
    • verifyElementNotPresent
    • verifyElementPresent
    • verifyLocation
    • verifyNotEditable
    • verifyText
    • verifyTextNotPresent
    • verifyTextPresent
    • verifyTitle
    • verifyValue
    • waitForElementNotPresent
    • waitForElementPresent
    • waitForNotVisible
    • waitForVisible


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.

Something went wrong with that request. Please try again.