cucumber-junit

Converts CucumberJS JSON output into JUnitXML for software like Jenkins to read.

Install

cucumber-junit should be added to your test codebase as a dev dependency. You can do this with:

1$ npm install --save-dev cucumber-junit

Alternatively you can manually add it to your package.json file:

1{
2  "devDependencies" : {
3    "cucumber-junit": "latest"
4  }
5}

then install with:

1$ npm install --dev

Run

cucumber-junit should be appended to your existing Cucumber.JS commands

1$ node_modules/.bin/cucumber-js --format=json | node_modules/.bin/cucumber-junit > output_JUnit.xml

The following options are supported by lib/cucumber_junit:

• strict - if true, pending or undefined steps will be reported as failures
• indent - passed to the [XML formatter][XML], defaults to 4 spaces
• stream - passed to the [XML formatter][XML] to return the result as a stream
• declaration - passed to the [XML formatter][XML]
• prefix - added to each test suite name (if test are executed against multiple browsers/devices)

These options can be specified on the command line when calling .bin/cucumber-junit:

• -s or --strict
• -i 4 or --indent 4
• -e UTF-8 or --encoding "UTF-*" - applied to the XML declaration

Gulp

cucumber-junit can be called from Gulp:

1gulp.task('cucumber:report', ['cucumber'], function() {
2    gulp.src('test-reports/cucumber.json')
3        .pipe(cucumberXmlReport({strict: true}))
4        .pipe(gulp.dest('test-reports'));
5});
6
7function cucumberXmlReport(opts) {
8    var gutil = require('gulp-util'),
9        through = require('through2'),
10        cucumberJunit = require('cucumber-junit');
11    
12    return through.obj(function (file, enc, cb) {
13        // If tests are executed against multiple browsers/devices
14        var suffix = file.path.match(/\/cucumber-?(.*)\.json/);
15        if (suffix) {
16            opts.prefix = suffix[1] + ';';
17        }
18        
19        var xml = cucumberJunit(file.contents, opts);
20        file.contents = new Buffer(xml);
21        file.path = gutil.replaceExtension(file.path, '.xml');
22        cb(null, file);
23    });
24}

License

MIT © St. John Johnson [XML]: https://www.npmjs.com/package/xml#options