README
grunt-qunit-tap
Grunt plugin for running QUnit tests with TAP reporting.
Useful for continuous integration tools (e.g. Jenkins with TAP plugin).
Getting Started
Version 2.*.*
of this plugin requires Grunt >= 0.4.*
Version 1.*.*
of this plugin requires Grunt 0.3.*
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-qunit-tap --save-dev
Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
grunt.loadNpmTasks('grunt-qunit-tap');
qunit-tap
task
The Overview
In your project's Gruntfile, add a section named qunit-tap
to the data object passed into grunt.initConfig()
.
grunt.initConfig({
'qunit-tap': {
your_target: {
// Target-specific file lists and/or options go here.
},
},
});
Options
options.output
Type: String
Default value: .
The folder where the TAP result files will be written.
Usage Examples
Default Options
Calling the qunit-tap
with a target, will call the qunit
task with the same target name.
Sample configuration:
grunt.initConfig({
qunit: {
foo: ["tests/**/*.html"]
},
'qunit-tap': {
foo: {
output: 'logs/'
}
}
});
Executing grunt qunit-tap:foo
will run the qunit:foo
task and write the TAP results in the logs/
folder.
Contributing
In lieu of a formal styleguide, take care to maintain the existing coding style.
Release History
- v2.0.0 - Updated for Grunt v0.4.*
- v1.0.3 - fixed duplicate TAP plan bug
- v1.0.2 - fixed random TAP plan issues
- v1.0.1 - fixed issue when running original qunit task
- v1.0.0 - first public release, compatible with grunt v0.3.*
License
Copyright (c) 2012-2014 Valentin Agachi
Licensed under the MIT license.