webpack-isomorphic-compiler-reporter

Beautiful reporting for webpack-isomorphic-compiler compilation events.

While webpack-sane-compiler-reporter works fine with this compiler, the output is incomplete. This reporter is specially designed to be isomorphic aware.

Installation

$ npm install webpack-isomorphic-compiler-reporter --save-dev

Usage

const startReporting = require('webpack-isomorphic-compiler-reporter');

const { stop, options } = startReporting(compiler, {/* options */});

// Now, just call compiler.run() or compiler.watch() to start a compilation and start outputting reports
// Calling stop() will stop listening to the compiler events
// Furthermore, you have access to the options that were computed by the merge of provided options and the defaults

Available options

| Name | Description | Type | Default | | ------ | ------------- | -------- | ------- | | stats | Display webpack stats after each compilation | boolean/string (true, false or 'once') | true | | humanErrors | Detects human errors related to webpack configuration mistakes (done only once) | boolean | true | | write | Function responsible for printing/outputting the generated report messages | function | Prints to stderr | | printStart | Function responsible for generating a message for when a compilation starts | function | | | printSuccess | Function responsible for generating a message when a compilation succeeds | function | | | printFailure | Function responsible for generating a message when a compilation fails | function | | | printInvalidate | Function responsible for generating a message when invalidate() is called when watching | function | | | printStats | Function responsible for generating a message representing a WebpackStats instance | function | | | printError | Function responsible for generating a message of a Error instance | function | |

Other exports

renderers

For convenience this package also exports the renderers used internally:

const reporter = require('webpack-isomorphic-compiler-reporter');

reporter(compiler, {
    printError: (err) => `${reporter.renderers.renderError(err)}\n`,
});

symbols

You can also access the symbols that precede some messages.

const reporter = require('webpack-isomorphic-compiler-reporter');

reporter(compiler, {
    printStart: () => `${reporter.symbols.start} A iniciar a compilação...\n`,
});

Tests

$ npm test
$ npm test -- --watch during development

License

MIT License