gulp.watch()

gulp.watch()介紹

監(jiān)聽 globs 并在發(fā)生更改時運行任務(wù)。任務(wù)與任務(wù)系統(tǒng)的其余部分被統(tǒng)一處理。

gulp.watch()用法

const { watch } = require('gulp');

watch(['input/*.js', '!input/something.js'], function(cb) {
  // body omitted
  cb();
}); 

gulp.watch()函數(shù)原型

watch(globs, [options], [task])

參數(shù)

返回值

chokidar 的一個實例，用于對監(jiān)聽設(shè)置進(jìn)行細(xì)粒度控制。

可能出現(xiàn)的錯誤

當(dāng)以 globs 形式傳遞非字符串或帶有任何非字符串的數(shù)組時，將拋出一個錯誤，并提示 "Non-string provided as watch path"。

當(dāng)字符串或數(shù)組作為 task 傳遞時，會拋出一個錯誤，提示 "watch task has to be a function (optionally generated by using gulp.parallel or gulp.series)"（ watch 任務(wù)必須是一個函數(shù)(可以選擇使用 gulp.parallel 或 gulp.series 生成))。

選項

Chokidar 實例

watch() 方法返回 chokidar 的底層實例，提供對監(jiān)聽設(shè)置的細(xì)粒度控制。最常用來注冊提供更改文件的 path 或 stats 的單個事件處理程序。

當(dāng)直接使用 chokidar 實例時，您將無法訪問任務(wù)系統(tǒng)集成，包括異步完成、隊列和延遲

const { watch } = require('gulp');

const watcher = watch(['input/*.js']);

watcher.on('change', function(path, stats) {
  console.log(`File ${path} was changed`);
});

watcher.on('add', function(path, stats) {
  console.log(`File ${path} was added`);
});

watcher.on('unlink', function(path, stats) {
  console.log(`File ${path} was removed`);
});

watcher.close();

watcher.on(eventName, eventHandler)

注冊 eventHandler 函數(shù)，當(dāng)指定的事件發(fā)生時調(diào)用該函數(shù)。

watcher.close()

關(guān)閉文件監(jiān)聽器。一旦關(guān)閉，就不會再發(fā)出任何事件。

watcher.add(globs)

向已經(jīng)運行的監(jiān)聽器實例添加額外的 globs。

watcher.unwatch(globs)

刪除正在被監(jiān)聽的 globs，而監(jiān)視程序繼續(xù)使用剩余的路徑。