Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »



    A grunt plugin that runs jasmine tests using webdriver.

    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 git+ssh://

    If you do not have stored ssh credentials for github, you will need to authenticate to complete the installation.

    The module can also be installed with package.json by adding a reference to the devDependencies block:

        "name": "your-app-name",
        "version": "99.99.99",
        "devDependencies": {
            "private-repo": "ssh://"

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


    Setting up webdriver

    Browser drivers will need to be installed for the browsers you plan to run tests on. If you use brew and want to run tests on Chrome, use the following command:

    brew install chromedriver

    The driver for firefox is included in the plugin.

    The "webdriver_jasmine_runner" task


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

                # your options here 


    Summary (w/ default values)

          seleniumJar: "#{__dirname}/lib/selenium-server-standalone-2.44.0.jar" # Only specified when starting a local selenium server 
          seleniumServerHost: undefined # Only specified when running tests on a remote selenium server 
          seleniumServerPort: 4444
          seleniumServerArgs: [# Only specified when starting a local selenium server 
          seleniumServerJvmArgs: [# Only specified when starting a local selenium server 
          browser: 'chrome'
          testServer: 'localhost'
          testServerPort: 8000
          testFile: '_SpecRunner.html'
          allTestsTimeout: 30 * 60 * 1000    # 30 minutes 
          keepalive: false


    • Type: String
    • Default value: "#{__dirname}/lib/selenium-server-standalone-2.44.0.jar"

    The location of the selenium standalone server jar.


    • Type: String
    • Default value: none

    The hostname of a remote selenium server to use. If specified, a selenium server won't be started.


    • Type: Number
    • Default value: 4444

    The port number to use for the local selenium server when running locally or the remote selenium server when using a remote server.


    • Type: Array
    • Default value: []

    Arguments to pass to the Selenium Server java command.


    • Type: Array
    • Default value: []

    JVM arguments to pass to the Selenium Server java command. (e.g. ['-Xmx256M'])


    • Type: String
    • Default value: 'chrome'
    • Allowed values: 'chrome', 'firefox', 'internet explorer', ... source

    The browser in which the tests will be run. This can also be specified via the --browser command-line option (below), which takes precedence.


    • Type: String
    • Default value: 'localhost'

    The address of the server where the application is running.


    • Type: Number
    • Default value: 8000

    The port where the application is running.


    • Type: String
    • Default value: '_SpecRunner.html'

    The file to load that runs the jasmine tests.


    • Type: Number
    • Default value: 30 * 60 * 1000 (30 minutes)

    Time in milliseconds to wait for all of the tests to finish running.


    • Type: Number
    • Default value: 20000 (20 seconds)

    Time in milliseconds to wait for the symbol summary to appear.

    Command-Line Options

    --browser=[chrome|firefox|internet explorer|...]


    The browser in which the tests will be run. Takes precedence over the "browser" gruntfile option (above).


    The selenium server and browser are not closed after the tests have been run. Useful for interactive debugging of failing tests.


    The selenium server added a parameter to the query string of url passed to the browser to tell Jasmine to disable verification of proper tests cleanup.


    Generates output of the spec title as test are run. e.g. Running Jasmine tests for '#{title}'


    This task:

    • logs the number of tests executed, the number of failed tests, and the full stack traces (Jasmine output) of any failing tests to the Grunt log.
    • fails if any tests fail.

    Usage Examples

    Default Options

    This task isn't very useful by itself. A usual use case if to configure webdriver_jasmine_runner in a grunt.initConfig() call and combine it with other tasks with grunt.registerTask().

    In this example, we start a connect server running the app. The jasmine:build task also creates an appropriate _SpecRunner.html file with the specs to be run.

                options: {}
    grunt.registerTask 'browser:test'['default''jasmine:build''connect''webdriver_jasmine_runner']



    npm i grunt-webdriver-jasmine-runner

    Downloadsweekly downloads







    last publish


    • avatar
    • avatar
    • avatar