Gulp lastRun()

lastRun()

检索在当前运行进程中成功完成任务的最后一次时间。最有用的后续任务运行时，监视程序正在运行。当监视程序正在运行时，对于后续的任务运行最有用。

当与 src() 组合时，通过跳过自上次成功完成任务以来没有更 改的文件，使增量构建能够加快执行时间。

用法

const { src, dest, lastRun, watch } = require('gulp');
const imagemin = require('gulp-imagemin');

function images() {
  return src('src/images/**/*.jpg', { since: lastRun(images) })
    .pipe(imagemin())
    .pipe(dest('build/img/'));
}

exports.default = function() {
  watch('src/images/**/*.jpg', images);
};

函数原型

lastRun(task, [precision])

参数

返回值

返回一个时间戳（以毫秒为单位），表示任务的最后完成时间。如果任务尚未运行或已经失败，则返回 undefined。

为了避免缓存无效状态（invalid state），因此，如果任务出错，则返回值为 undefined。

可能出现的错误

当传入的参数值不是字符串或函数时，会抛出一个错误，并显示错误信息 “Only functions can check lastRun”。

当对不可扩展的函进行数调或 Node 不支持 WeakMap 时，会抛出一个错误，并显示错误信息 “Only extensible functions can check lastRun”。

时间戳精度

虽然时间戳的精度有合理的默认值，但仍然可以通过 precision 参数对其进行舍入。如果你所使用文件系统或 Node 版本对文件的时间属性精度不高的话，则很有用。

• lastRun(someTask) 返回 1426000001111
• lastRun(someTask, 100) 返回 1426000001100
• lastRun(someTask, 1000) 返回 1426000001000

文件的 mtime stat 精度会由于 node 版本和/或所用的文件系统而出现误差。