DEPRECATED: Starting from @stryker-mutator/core version 3.0.0 the HTML reporter is included with Stryker and enabled by default. There is no reason to install this package.

Stryker HTML Reporter

An HTML Reporter for the JavaScript mutation testing framework Stryker

Example

Click on the image below to see a real-life example of a report generated from a test run on stryker itself!

Install

Install @stryker-mutator/html-reporter from your project folder:

npm i --save-dev @stryker-mutator/html-reporter

Configuring

You can either configure the html reporter from the stryker.conf.js file or from the command line. This readme describes how to do it via the config file.

Load the plugin

In order to use the @stryker-mutator/html-reporter it must be loaded in the stryker mutation testing framework via the stryker configuration. Easiest is to leave out the plugins section from your config entirely. That way, all node_modules starting with @stryker-mutator/* will be loaded.

If you do descide to choose specific modules, don't forget to add '@stryker-mutator/html-reporter' to the list of plugins to load.

Use the reporter

In order to use the reporter, you must add 'html' to the reporters. For example: reporters: ['html', 'progress'].

Options

You can configure the html reporter by adding a htmlReporter object to your config.

htmlReporter.baseDir

Configure the base directory to write the html report to.

Full config example

// stryker.conf.js
exports = function(config){
    config.set({
        // ...
        reporters: ['html'], // You may also want to specify other reporters
        htmlReporter: {
            baseDir: 'reports/mutation/html' // this is the default
        },
        plugins: ['@stryker-mutator/html-reporter'] // Or leave out the plugin list entirely to load all @stryker-mutator/* plugins directly
        // ...
    });
}

Usage

Use Stryker as you normally would. The report will be available where you have configured it, or in the reports/mutation/html as a default. See https://stryker-mutator.io for more info.