gulp.watch()介紹

監(jiān)聽(tīng) globs 并在發(fā)生更改時(shí)運(yùn)行任務(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 的一個(gè)實(shí)例，用于對(duì)監(jiān)聽(tīng)設(shè)置進(jìn)行細(xì)粒度控制。

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

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

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

選項(xiàng)

Chokidar 實(shí)例

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

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

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)

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

watcher.close()

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

watcher.add(globs)

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

watcher.unwatch(globs)

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