karma-tap-pretty-reporter

a Karma TAP Reporter and Prettifier

Usage no npm install needed!

<script type="module">
  import karmaTapPrettyReporter from 'https://cdn.skypack.dev/karma-tap-pretty-reporter';
</script>

README

karma-tap-pretty-reporter

npm version npm downloads Build Status Windows Tests Donate

a Karma reporter plugin for report and prettify TAP test results

Installation

npm

npm install karma karma-tap karma-tap-pretty-reporter --save-dev

[optional] install a prettify package. See below supported prettifiers

npm install faucet --save-dev

Usage

Add karma.conf.js file to project.

Example:

// karma.conf.js
module.exports = function(config) {
  config.set({
    reporters: ['tap-pretty'],

    tapReporter: {
      prettify: require('faucet'), // default 'standard TAP' output
      separator: '****************************'
    },
  });
};

Using separator

On Karma autoWatch mode maybe we need separate test run cycles output. Create a separator string for this purpose.

In order of not pollute output, separator will be shown only if LogLevel is different of LOG_INFO nor LOG_DEBUG

Report to a file

Optionally you can save report to a file and turn off output to the console.

// karma.conf.js

reporters: ['tap-pretty'],

tapReporter: {
  outputFile: './test.out.tap',
  disableStdout: true            // default 'false'
},

Supported prettifiers

Use Cases

Show only 'failed' test

Install tap-difflet package

npm install tap-difflet --save-dev

Add settings to tapReporter on karma.conf.js

tapReporter: {
      // outputFile: './unit.tap',
      prettify: function() { return require('tap-difflet')({ pessimistic: true }); },
      separator: '****************************',
    },

Example

Credits

author

contributors

Contributing

  • Documentation improvement
  • Feel free to send any PR

License

ISC