Webpack Notifier 2

This is a webpack plugin that uses the node-notifier package to display build status system notifications to the user.

This is a fork of the webpack-notifier which is a fork of the webpack-error-notification plugin. It adds support for Windows and there is no need to manually install the terminal-notifier package on OS X anymore.

The plugin will notify you about the first run (success/fail), all failed runs and the first successful run after recovering from a build failure. In other words: it will stay silent if everything is fine with your build.

Installation

Use npm to install this package:

npm install --save-dev webpack-notifier

Check the node-notifier Requirements whether you need to install any additional tools for your OS.

Usage

In the webpack.config.js file:

1var WebpackNotifierPlugin = require('webpack-notifier');
2
3var config = module.exports = {
4  // ...
5
6  plugins: [
7    new WebpackNotifierPlugin(),
8  ]
9},

Configuration

Title

Title shown in the notification.

1new WebpackNotifierPlugin({title: 'Webpack'});

1var path = require('path');
2
3new WebpackNotifierPlugin({title: function (params) {
4  return `Build status is ${params.status} with message ${params.message}`;
5}});

Emojis in message text

1var path = require('path');
2
3new WebpackNotifierPlugin({emoji: true});

Content Image

Image shown in the notification. Can be a path string or object with paths.

String path:

1var path = require('path');
2
3new WebpackNotifierPlugin({contentImage: path.join(__dirname, 'logo.png')});

Object string path:

1var path = require('path');
2
3const statusesPaths = {
4  success: path.join(__dirname, 'success.png')
5  warning: path.join(__dirname, 'warning.png')
6  error: path.join(__dirname, 'error.png')
7}
8
9new WebpackNotifierPlugin({contentImage: statusesPaths});

Exclude Warnings

If set to true, warnings will not cause a notification.

1new WebpackNotifierPlugin({excludeWarnings: true});

Always Notify

Trigger a notification every time. Call it "noisy-mode".

1new WebpackNotifierPlugin({alwaysNotify: true});

Notify on error

Trigger a notification only on error.

1new WebpackNotifierPlugin({onlyOnError: true});

Skip Notification on the First Build

Do not notify on the first build. This allows you to receive notifications on subsequent incremental builds without being notified on the initial build.

1new WebpackNotifierPlugin({skipFirstNotification: true});