gulp常用插件之gulp-notify使用

更多gulp常用插件使用请访问：gulp常用插件汇总

---

gulp-notify这是一款gulp通知插件。

更多使用文档请点击访问gulp-notify工具官网。

安装

一键安装不多解释

npm install --save-dev gulp-notify

使用

例1：

var notify = require("gulp-notify");
gulp.src("./src/test.ext")
  .pipe(notify("Hello Gulp!"));

例2：

var notify = require("gulp-notify");
gulp.src("./src/test.ext")
  .pipe(notify("Found file: <%= file.relative %>!"));

有关更多输入，请参见示例，或参见API部分。

注释/提示

即使出错，gulp-notify也会传递vinyl files 。因此，如果您使用的是gulp-plumber ，如果通知程序返回错误，则运行不会中断。

如果你想通知错误，可以使用gulp-plumber 不中断运行，迫使你不得不重新启动gulp。

您可以使用notify.onError()作为gulp-plumber的errorHandler ，如下所示：

gulp.src("../test/fixtures/*")
      .pipe(plumber({errorHandler: notify.onError("Error: <%= error.message %>")}))
      .pipe(through(function () {
        this.emit("error", new Error("Something happend: Error message!"))
      }));

API

• notify(String)
  
  用于通知流中每个数据的消息。字符串可以是lodash模板，因为它通过gulp-util.template传递。
• notify(Function)
  
  类型： function(VinylFile)
  
  来自gulp流的Vinyl File作为参数传入。
  
  该函数的结果可以是用作消息的字符串或选项对象（请参见下文）。如果返回值是一个字符串，则它可以是lodash模板，因为它是通过gulp-util.template传递的。
  
  如果false从函数返回，则通知将不会运行。
• notify(options)

选项传递到报告程序上，因此在Windows上，您可以定义Growl主机，在Mac上，您可以传递contentImage，依此类推。

有关 所有选项，请参阅节点通知程序

默认通知值：

* 定期通知的Gulp徽标

* 错误时倒置了Gulp徽标

* 在Mac上，青蛙声音错误。

另请参见高级示例。

• options.onLast
  
  类型：Boolean
  
  默认值：false
  
  如果通知仅应在流的最后一个文件上发生。默认情况下，每个文件都会触发通知。
• options.emitError
  
  类型：Boolean
  
  默认值：false
  
  返回的流是否应该发出错误。如果emitError为true，则必须.on('error') 手动处理，以防通知程序（gulp-notify）失败。如果false设置了默认值，则不会发出错误，而只是将其打印到控制台。
  
  这意味着您可以在CI系统上运行通知程序，而无需选择退出，而只是让其正常地失败。
• options.message
  
  类型：String
  
  默认：流中的文件路径
  
  您希望附加到文件的消息。字符串可以是lodash模板，因为它通过gulp-util.template传递。
  
  范例：Created <%= file.relative %>。
• 作为功能函数
  
  类型： Function(vinylFile)
  
  请参阅notify(Function)。
• options.title
  
  类型：String
  
  默认：“ Gulp通知”
  
  通知的标题。字符串可以是lodash模板，因为它通过gulp-util.template传递。
  
  范例：Created <%= file.relative %>。
• 作为功能函数
  
  类型： Function(vinylFile)
  
  请参阅notify(Function)。
• options.templateOptions
  
  类型：Object
  
  默认值：{}
  
  传递给lodash模板的对象，用于传递给模板的其他属性。

gulp.src("../test/fixtures/*")
    .pipe(notify({
      message: "Generated file: <%= file.relative %> @ <%= options.date %>",
      templateOptions: {
        date: new Date()
      }
    }))

• options.notifier
  
  类型：Function(options, callback)
  
  默认：node-notifier模块
  
  通过传入函数来交换通知程序。该函数需要两个参数：options和callback。
  
  通知完成后必须调用回调。选项将同时包含标题和消息。
  
  请参阅notify.withReporter语法糖。

notify.on(event, function (notificationOptions)) - Events

如果该wait选项设置为true，则通知者将触发事件click或timeout，无论用户单击通知还是超时。您在主通知对象（而不是产生流）上侦听这些事件。

var notify = require('gulp-notify');

notify.on('click', function (options) {
  console.log('I clicked something!', options);
});

notify.on('timeout', function (options) {
  console.log('The notification timed out', options);
});

gulp.task("click", function () {
  return gulp.src("some/glob/**")
    .pipe(notify({ message: 'Click or wait', wait: true }));
});

notify.withReporter(Function)

类型： Reporter

包装options.notifier仅使用传入的报告程序返回新的通知功能。

例：

var custom = notify.withReporter(function (options, callback) {
  console.log("Title:", options.title);
  console.log("Message:", options.message);
  callback();
});

gulp.src("../test/fixtures/1.txt")
    .pipe(custom("This is a message."));

这将与

gulp.src("../test/fixtures/1.txt")
    .pipe(notify({
      message: "This is a message."
      notifier: function (options, callback) {
        console.log("Title:", options.title);
        console.log("Message:", options.message);
        callback();
      }
    }));

但是，很多漂亮。

notify.onError（）

与using完全相同的API notify()，但是在vinyl File 传递a的地方，传递错误对象。

例：

gulp.src("../test/fixtures/*")
      .pipe(through(function () {
        this.emit("error", new Error("Something happend: Error message!"))
      }))
      .on("error", notify.onError(function (error) {
        return "Message to the notifier: " + error.message;
      }));

或者简单地：

gulp.src("../test/fixtures/*")
      .pipe(through(function () {
        this.emit("error", new Error("Something happend: Error message!"))
      }))
      .on("error", notify.onError("Error: <%= error.message %>"));

gulp.src("../test/fixtures/*")
      .pipe(through(function () {
        this.emit("error", new Error("Something happend: Error message!"))
      }))
      .on("error", notify.onError({
        message: "Error: <%= error.message %>",
        title: "Error running something"
      }));

在onError()终点不支持lodash.template。

onError()会自动为您结束视频流。使观看更加轻松。

notify.logLevel(level)

类型：Integer

默认值：2

设置是否使用记录器。如果日志级别设置为0，将不使用任何日志记录。如果未传递新的日志级别，则返回当前日志级别。

• 0：无日志记录
• 1：登录错误
• 2：记录错误和常规通知。
  
  如果将logging设置为> 0，则将记录标题和传递给的消息，gulp-notify如下所示：

➜  gulp-notify git:(master) ✗ gulp --gulpfile examples/gulpfile.js one
[gulp] Using file /Users/example/gulp-notify/examples/gulpfile.js
[gulp] Working directory changed to /Users/example/repos/gulp-notify/examples
[gulp] Running 'one'...
[gulp] Finished 'one' in 4.08 ms
[gulp] gulp-notify: [Gulp notification] /Users/example/gulp-notify/test/fixtures/1.txt

禁用 gulp-notify

如果您运行的系统处理通知的能力很差，或者只是不想使用，gulp-notify而您的项目可以呢？您可以gulp-notify 使用环境变量禁用它DISABLE_NOTIFIER。

export DISABLE_NOTIFIER=true;

这将禁用所有方法。notify()，notify.onError和notify.withReporter。

例子：

要查看从根目录运行的所有示例：

$ gulp --gulpfile examples/gulpfile.js --tasks
[gulp] Using file /Users/example/gulp-notify/examples/gulpfile.js
[gulp] Working directory changed to /Users/example/gulp-notify/examples
[gulp] Tasks for /Users/example/gulp-notify/examples/gulpfile.js
[gulp] ├── multiple
[gulp] ├── one
[gulp] ├── message
[gulp] ├── customReporter
[gulp] ├── template
[gulp] ├── templateadv
[gulp] ├── function
[gulp] ├── onlast
[gulp] ├── advanceMac
[gulp] ├── error
[gulp] ├── forceGrowl
[gulp] └── customError

运行示例：

$ gulp --gulpfile examples/gulpfile.js multiple
[gulp] Using file /Users/example/gulp-notify/examples/gulpfile.js
[gulp] Working directory changed to /Users/example/gulp-notify/examples
[gulp] Running 'multiple'...
[gulp] Finished 'multiple' in 3.75 ms

作为jshint报告员

gulp-notify可以轻松用作jshint报告程序。当jshint在乙烯基文件上公开结果时，我们可以在如下函数中使用它们：

gulp.task('lint', function() {
  gulp.src('/src/**/*.js')
    .pipe(jshint())
    // 使用gulp-notify作为jshint报告器
    .pipe(notify(function (file) {
      if (file.jshint.success) {
        // 不显示的东西，如果成功
        return false;
      }

      var errors = file.jshint.results.map(function (data) {
        if (data.error) {
          return "(" + data.error.line + ':' + data.error.character + ') ' + data.error.reason;
        }
      }).join("\n");
      return file.relative + " (" + file.jshint.results.length + " errors)\n" + errors;
    }));
});

如果您在中使用消息功能gulp-notify，则不会显示该消息。直接使用function和都是如此{ message: function () {}}。