Grunt task for running Cucumber.js
Last updated 6 years ago by ieb .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install grunt-cucumber-sigma 
SYNC missed versions from official npm registry.


Simple and easy way to run your cucumber scripts from Grunt.

NOTE This is a fork of which appears to have gone stale.

This updated repo is available through npm install grunt-cucumber-sigma. The only change in this repo is to require later versions of the official Cucumber repo, which include updated features and bug fixes.

Getting Started

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

Then add this configuration to your project's Gruntfile.js.


Cucumberjs Task

Run this task with the grunt cucumberjs command.



Type: String

Default: ''

Require files before executing the features. If this option is not specified, all *.js and *.coffee files that are siblings or below the features will be loaded automatically. Automatic loading is disabled when this option is specified, and all loading becomes explicit.

Files under directories named "support" are always loaded first.


Type: String|Array

Default: ''

Only execute the features or scenarios with tags matching TAG_EXPRESSION. Scenarios inherit tags declared on the Feature level. The simplest TAG_EXPRESSION is simply a tag. Example: tags: '@dev'

When a tag in a tag expression starts with a ~, this represents boolean NOT. Example: tags: '~@dev'

A tag expression can have several tags separated by a comma, which represents logical OR. Example: tags: '@dev,@wip'

A tag expression can have an array of tags to be applied, this represents a logical AND. Example:

tags: ['@dev',@wip]


Type: String

Default: ''

How to format features (default: progress). Available formats:

  • pretty : prints the feature as is
  • progress: prints one character per scenario
  • json : prints the feature as JSON
  • summary : prints a summary only, after all scenarios were executed


Type: String

Default: 'cucumber'

Used to set the path to Cucumber.js's lib/cucumber.js file if you don't want to load it from the npm_modules directory using the default require('cucumber'). Useful for running customized versions of Cucumber.js for a specific project. It is helpful when you need to modify the Cucumber.js lib but you can not open source the contributions.

Example: modulePath: "../../custom_libs/cucumberjs/lib/cucumber.js"


Type: Boolean

Default: false

When true, cucumberjs will output code snippets in coffeescript

Usage Examples

Basic Use

// Project configuration.
  cucumberjs: {
    src: 'path/to/features',
    options: {
      steps: "path/to/step_definitions"

Getting started with Cucumber



Help us squash them by submitting an issue that describes how you encountered it; please be as specific as possible including operating system, node, grunt, and grunt-cucumber-js versions.

Release History



Copyright (c) 2012 "s9tpepper" Omar Gonzalez & contributors. Licensed under the MIT license.

Current Tags

  • 0.3.7                                ...           latest (5 years ago)

10 Versions

  • 0.3.7                                ...           5 years ago
  • 0.3.6                                ...           5 years ago
  • 0.3.5                                ...           5 years ago
  • 0.3.4                                ...           5 years ago
  • 0.3.3                                ...           6 years ago
  • 0.3.2                                ...           6 years ago
  • 0.3.1                                ...           6 years ago
  • 0.3.0                                ...           6 years ago
  • 0.2.4                                ...           6 years ago
  • 0.2.3                                ...           6 years ago
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (1)
Dev Dependencies (2)
Dependents (1)

Copyright 2014 - 2017 © |