Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A grunt task for running vows test specs
Branch: master


latest commit 7fce312180
@CMTegner authored
Failed to load latest commit information.
bin Fix grunt-vows executable (#15)
src Remove unused import
tasks Fixing vows executable clusterfuck
test Prepend "node" to executable path to make task work on Windows
.jshintrc Add .jshintrc and remove options from Gruntfile
LICENSE-MIT Update readme

grunt-vows Build Status devDependency Status NPM version

A grunt task for running your vows test specs.


npm install grunt-vows


Either run it via grunt by first adding this line to your project's grunt.js gruntfile:


then by running the vows task directly (or via an alias):

grunt vows

or you can run it as a stand-alone command:


(requires global installation, i.e. npm install -g grunt-vows)


Note: As of version 0.2.0 grunt-vows is a multi-task!

Configuration is handled via the default grunt multi-task config schema:

    vows: {
        all: {
            options: {
                // String {spec|json|dot-matrix|xunit|tap}
                // defaults to "dot-matrix"
                reporter: "spec",
                // String or RegExp which is
                // matched against title to
                // restrict which tests to run
                onlyRun: /helper/,
                // Boolean, defaults to false
                verbose: false,
                // Boolean, defaults to false
                silent: false,
                // Colorize reporter output,
                // boolean, defaults to true
                colors: true,
                // Run each test in its own
                // vows process, defaults to
                // false
                isolate: false,
                // String {plain|html|json|xml}
                // defaults to none
                coverage: "json"
            // String or array of strings
            // determining which files to include.
            // This option is grunt's "full" file format.
            src: ["test/*.js", "spec/*"]

Release History

  • 2015-01-28   v0.4.2   Fix npm package entry point (main); fix grunt-vows executable
  • 2014-04-11   v0.4.1   Made task work on Windows
  • 2013-02-18   v0.4.0   Grunt 0.4.0 compatible. Implemented support for this.options() and this.files.
  • 2012-12-28   v0.3.1   Fixing a regression in support for older versions of Node.
  • 2012-12-28   v0.3.0   Added support for coverage options.
  • 2012-10-29   v0.2.1   Updated to be Grunt 0.4 compatible. Added support for "isolate" option.
  • 2012-10-01   v0.2.0   Made "grunt-vows" a multi-task.
  • 2012-09-29   v0.1.3   Added support for two undocumented reporters. Fixed a bug which could prevent the task from correctly reporting test failures.
  • 2012-09-22   v0.1.2   Added "reporter", "onlyRun", "verbose", "silent", and "no-color" configuration options.
  • 2012-09-20   v0.1.1   Added "files" configuration option for specifying which files to look for specs in.
  • 2012-09-16   v0.1.0   Initial release.


Copyright (c) 2012-2013 Christian Maughan Tegnér Licensed under the MIT license.

Something went wrong with that request. Please try again.