You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
94 lines
2.2 KiB
94 lines
2.2 KiB
4 years ago
|
# webpack-notifier
|
||
|
|
|
||
|
|
[](https://travis-ci.org/Turbo87/webpack-notifier)
|
||
|
|
[](https://www.npmjs.com/package/webpack-notifier)
|
||
|
|
|
||
|
|
This is a [webpack](http://webpack.github.io/) plugin that uses the
|
||
|
|
[node-notifier](https://github.com/mikaelbr/node-notifier) package to
|
||
|
|
display build status system notifications to the user.
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
> This is a fork of the
|
||
|
|
[webpack-error-notification](https://github.com/vsolovyov/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](https://github.com/mikaelbr/node-notifier#requirements)
|
||
|
|
whether you need to install any additional tools for your OS.
|
||
|
|
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
In the `webpack.config.js` file:
|
||
|
|
|
||
|
|
```js
|
||
|
|
var WebpackNotifierPlugin = require('webpack-notifier');
|
||
|
|
|
||
|
|
var config = module.exports = {
|
||
|
|
// ...
|
||
|
|
|
||
|
|
plugins: [
|
||
|
|
new WebpackNotifierPlugin(),
|
||
|
|
]
|
||
|
|
},
|
||
|
|
```
|
||
|
|
|
||
|
|
|
||
|
|
## Configuration
|
||
|
|
|
||
|
|
### Title
|
||
|
|
|
||
|
|
Title shown in the notification.
|
||
|
|
|
||
|
|
```js
|
||
|
|
new WebpackNotifierPlugin({title: 'Webpack'});
|
||
|
|
```
|
||
|
|
|
||
|
|
### Content Image
|
||
|
|
|
||
|
|
Image shown in the notification.
|
||
|
|
|
||
|
|
```js
|
||
|
|
var path = require('path');
|
||
|
|
|
||
|
|
new WebpackNotifierPlugin({contentImage: path.join(__dirname, 'logo.png')});
|
||
|
|
```
|
||
|
|
|
||
|
|
### Exclude Warnings
|
||
|
|
|
||
|
|
If set to `true`, warnings will not cause a notification.
|
||
|
|
|
||
|
|
```js
|
||
|
|
new WebpackNotifierPlugin({excludeWarnings: true});
|
||
|
|
```
|
||
|
|
|
||
|
|
### Always Notify
|
||
|
|
|
||
|
|
Trigger a notification every time. Call it "noisy-mode".
|
||
|
|
|
||
|
|
```js
|
||
|
|
new WebpackNotifierPlugin({alwaysNotify: 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.
|
||
|
|
|
||
|
|
```js
|
||
|
|
new WebpackNotifierPlugin({skipFirstNotification: true});
|
||
|
|
```
|