1 | "use strict";
|
---|
2 | Object.defineProperty(exports, "__esModule", { value: true });
|
---|
3 | exports.FSWatcher = exports.WatchHelper = void 0;
|
---|
4 | exports.watch = watch;
|
---|
5 | const fs_1 = require("fs");
|
---|
6 | const promises_1 = require("fs/promises");
|
---|
7 | const events_1 = require("events");
|
---|
8 | const sysPath = require("path");
|
---|
9 | const readdirp_1 = require("readdirp");
|
---|
10 | const handler_js_1 = require("./handler.js");
|
---|
11 | const SLASH = '/';
|
---|
12 | const SLASH_SLASH = '//';
|
---|
13 | const ONE_DOT = '.';
|
---|
14 | const TWO_DOTS = '..';
|
---|
15 | const STRING_TYPE = 'string';
|
---|
16 | const BACK_SLASH_RE = /\\/g;
|
---|
17 | const DOUBLE_SLASH_RE = /\/\//;
|
---|
18 | const DOT_RE = /\..*\.(sw[px])$|~$|\.subl.*\.tmp/;
|
---|
19 | const REPLACER_RE = /^\.[/\\]/;
|
---|
20 | function arrify(item) {
|
---|
21 | return Array.isArray(item) ? item : [item];
|
---|
22 | }
|
---|
23 | const isMatcherObject = (matcher) => typeof matcher === 'object' && matcher !== null && !(matcher instanceof RegExp);
|
---|
24 | function createPattern(matcher) {
|
---|
25 | if (typeof matcher === 'function')
|
---|
26 | return matcher;
|
---|
27 | if (typeof matcher === 'string')
|
---|
28 | return (string) => matcher === string;
|
---|
29 | if (matcher instanceof RegExp)
|
---|
30 | return (string) => matcher.test(string);
|
---|
31 | if (typeof matcher === 'object' && matcher !== null) {
|
---|
32 | return (string) => {
|
---|
33 | if (matcher.path === string)
|
---|
34 | return true;
|
---|
35 | if (matcher.recursive) {
|
---|
36 | const relative = sysPath.relative(matcher.path, string);
|
---|
37 | if (!relative) {
|
---|
38 | return false;
|
---|
39 | }
|
---|
40 | return !relative.startsWith('..') && !sysPath.isAbsolute(relative);
|
---|
41 | }
|
---|
42 | return false;
|
---|
43 | };
|
---|
44 | }
|
---|
45 | return () => false;
|
---|
46 | }
|
---|
47 | function normalizePath(path) {
|
---|
48 | if (typeof path !== 'string')
|
---|
49 | throw new Error('string expected');
|
---|
50 | path = sysPath.normalize(path);
|
---|
51 | path = path.replace(/\\/g, '/');
|
---|
52 | let prepend = false;
|
---|
53 | if (path.startsWith('//'))
|
---|
54 | prepend = true;
|
---|
55 | const DOUBLE_SLASH_RE = /\/\//;
|
---|
56 | while (path.match(DOUBLE_SLASH_RE))
|
---|
57 | path = path.replace(DOUBLE_SLASH_RE, '/');
|
---|
58 | if (prepend)
|
---|
59 | path = '/' + path;
|
---|
60 | return path;
|
---|
61 | }
|
---|
62 | function matchPatterns(patterns, testString, stats) {
|
---|
63 | const path = normalizePath(testString);
|
---|
64 | for (let index = 0; index < patterns.length; index++) {
|
---|
65 | const pattern = patterns[index];
|
---|
66 | if (pattern(path, stats)) {
|
---|
67 | return true;
|
---|
68 | }
|
---|
69 | }
|
---|
70 | return false;
|
---|
71 | }
|
---|
72 | function anymatch(matchers, testString) {
|
---|
73 | if (matchers == null) {
|
---|
74 | throw new TypeError('anymatch: specify first argument');
|
---|
75 | }
|
---|
76 | // Early cache for matchers.
|
---|
77 | const matchersArray = arrify(matchers);
|
---|
78 | const patterns = matchersArray.map((matcher) => createPattern(matcher));
|
---|
79 | if (testString == null) {
|
---|
80 | return (testString, stats) => {
|
---|
81 | return matchPatterns(patterns, testString, stats);
|
---|
82 | };
|
---|
83 | }
|
---|
84 | return matchPatterns(patterns, testString);
|
---|
85 | }
|
---|
86 | const unifyPaths = (paths_) => {
|
---|
87 | const paths = arrify(paths_).flat();
|
---|
88 | if (!paths.every((p) => typeof p === STRING_TYPE)) {
|
---|
89 | throw new TypeError(`Non-string provided as watch path: ${paths}`);
|
---|
90 | }
|
---|
91 | return paths.map(normalizePathToUnix);
|
---|
92 | };
|
---|
93 | // If SLASH_SLASH occurs at the beginning of path, it is not replaced
|
---|
94 | // because "//StoragePC/DrivePool/Movies" is a valid network path
|
---|
95 | const toUnix = (string) => {
|
---|
96 | let str = string.replace(BACK_SLASH_RE, SLASH);
|
---|
97 | let prepend = false;
|
---|
98 | if (str.startsWith(SLASH_SLASH)) {
|
---|
99 | prepend = true;
|
---|
100 | }
|
---|
101 | while (str.match(DOUBLE_SLASH_RE)) {
|
---|
102 | str = str.replace(DOUBLE_SLASH_RE, SLASH);
|
---|
103 | }
|
---|
104 | if (prepend) {
|
---|
105 | str = SLASH + str;
|
---|
106 | }
|
---|
107 | return str;
|
---|
108 | };
|
---|
109 | // Our version of upath.normalize
|
---|
110 | // TODO: this is not equal to path-normalize module - investigate why
|
---|
111 | const normalizePathToUnix = (path) => toUnix(sysPath.normalize(toUnix(path)));
|
---|
112 | // TODO: refactor
|
---|
113 | const normalizeIgnored = (cwd = '') => (path) => {
|
---|
114 | if (typeof path === 'string') {
|
---|
115 | return normalizePathToUnix(sysPath.isAbsolute(path) ? path : sysPath.join(cwd, path));
|
---|
116 | }
|
---|
117 | else {
|
---|
118 | return path;
|
---|
119 | }
|
---|
120 | };
|
---|
121 | const getAbsolutePath = (path, cwd) => {
|
---|
122 | if (sysPath.isAbsolute(path)) {
|
---|
123 | return path;
|
---|
124 | }
|
---|
125 | return sysPath.join(cwd, path);
|
---|
126 | };
|
---|
127 | const EMPTY_SET = Object.freeze(new Set());
|
---|
128 | /**
|
---|
129 | * Directory entry.
|
---|
130 | */
|
---|
131 | class DirEntry {
|
---|
132 | constructor(dir, removeWatcher) {
|
---|
133 | this.path = dir;
|
---|
134 | this._removeWatcher = removeWatcher;
|
---|
135 | this.items = new Set();
|
---|
136 | }
|
---|
137 | add(item) {
|
---|
138 | const { items } = this;
|
---|
139 | if (!items)
|
---|
140 | return;
|
---|
141 | if (item !== ONE_DOT && item !== TWO_DOTS)
|
---|
142 | items.add(item);
|
---|
143 | }
|
---|
144 | async remove(item) {
|
---|
145 | const { items } = this;
|
---|
146 | if (!items)
|
---|
147 | return;
|
---|
148 | items.delete(item);
|
---|
149 | if (items.size > 0)
|
---|
150 | return;
|
---|
151 | const dir = this.path;
|
---|
152 | try {
|
---|
153 | await (0, promises_1.readdir)(dir);
|
---|
154 | }
|
---|
155 | catch (err) {
|
---|
156 | if (this._removeWatcher) {
|
---|
157 | this._removeWatcher(sysPath.dirname(dir), sysPath.basename(dir));
|
---|
158 | }
|
---|
159 | }
|
---|
160 | }
|
---|
161 | has(item) {
|
---|
162 | const { items } = this;
|
---|
163 | if (!items)
|
---|
164 | return;
|
---|
165 | return items.has(item);
|
---|
166 | }
|
---|
167 | getChildren() {
|
---|
168 | const { items } = this;
|
---|
169 | if (!items)
|
---|
170 | return [];
|
---|
171 | return [...items.values()];
|
---|
172 | }
|
---|
173 | dispose() {
|
---|
174 | this.items.clear();
|
---|
175 | this.path = '';
|
---|
176 | this._removeWatcher = handler_js_1.EMPTY_FN;
|
---|
177 | this.items = EMPTY_SET;
|
---|
178 | Object.freeze(this);
|
---|
179 | }
|
---|
180 | }
|
---|
181 | const STAT_METHOD_F = 'stat';
|
---|
182 | const STAT_METHOD_L = 'lstat';
|
---|
183 | class WatchHelper {
|
---|
184 | constructor(path, follow, fsw) {
|
---|
185 | this.fsw = fsw;
|
---|
186 | const watchPath = path;
|
---|
187 | this.path = path = path.replace(REPLACER_RE, '');
|
---|
188 | this.watchPath = watchPath;
|
---|
189 | this.fullWatchPath = sysPath.resolve(watchPath);
|
---|
190 | this.dirParts = [];
|
---|
191 | this.dirParts.forEach((parts) => {
|
---|
192 | if (parts.length > 1)
|
---|
193 | parts.pop();
|
---|
194 | });
|
---|
195 | this.followSymlinks = follow;
|
---|
196 | this.statMethod = follow ? STAT_METHOD_F : STAT_METHOD_L;
|
---|
197 | }
|
---|
198 | entryPath(entry) {
|
---|
199 | return sysPath.join(this.watchPath, sysPath.relative(this.watchPath, entry.fullPath));
|
---|
200 | }
|
---|
201 | filterPath(entry) {
|
---|
202 | const { stats } = entry;
|
---|
203 | if (stats && stats.isSymbolicLink())
|
---|
204 | return this.filterDir(entry);
|
---|
205 | const resolvedPath = this.entryPath(entry);
|
---|
206 | // TODO: what if stats is undefined? remove !
|
---|
207 | return this.fsw._isntIgnored(resolvedPath, stats) && this.fsw._hasReadPermissions(stats);
|
---|
208 | }
|
---|
209 | filterDir(entry) {
|
---|
210 | return this.fsw._isntIgnored(this.entryPath(entry), entry.stats);
|
---|
211 | }
|
---|
212 | }
|
---|
213 | exports.WatchHelper = WatchHelper;
|
---|
214 | /**
|
---|
215 | * Watches files & directories for changes. Emitted events:
|
---|
216 | * `add`, `addDir`, `change`, `unlink`, `unlinkDir`, `all`, `error`
|
---|
217 | *
|
---|
218 | * new FSWatcher()
|
---|
219 | * .add(directories)
|
---|
220 | * .on('add', path => log('File', path, 'was added'))
|
---|
221 | */
|
---|
222 | class FSWatcher extends events_1.EventEmitter {
|
---|
223 | // Not indenting methods for history sake; for now.
|
---|
224 | constructor(_opts = {}) {
|
---|
225 | super();
|
---|
226 | this.closed = false;
|
---|
227 | this._closers = new Map();
|
---|
228 | this._ignoredPaths = new Set();
|
---|
229 | this._throttled = new Map();
|
---|
230 | this._streams = new Set();
|
---|
231 | this._symlinkPaths = new Map();
|
---|
232 | this._watched = new Map();
|
---|
233 | this._pendingWrites = new Map();
|
---|
234 | this._pendingUnlinks = new Map();
|
---|
235 | this._readyCount = 0;
|
---|
236 | this._readyEmitted = false;
|
---|
237 | const awf = _opts.awaitWriteFinish;
|
---|
238 | const DEF_AWF = { stabilityThreshold: 2000, pollInterval: 100 };
|
---|
239 | const opts = {
|
---|
240 | // Defaults
|
---|
241 | persistent: true,
|
---|
242 | ignoreInitial: false,
|
---|
243 | ignorePermissionErrors: false,
|
---|
244 | interval: 100,
|
---|
245 | binaryInterval: 300,
|
---|
246 | followSymlinks: true,
|
---|
247 | usePolling: false,
|
---|
248 | // useAsync: false,
|
---|
249 | atomic: true, // NOTE: overwritten later (depends on usePolling)
|
---|
250 | ..._opts,
|
---|
251 | // Change format
|
---|
252 | ignored: _opts.ignored ? arrify(_opts.ignored) : arrify([]),
|
---|
253 | awaitWriteFinish: awf === true ? DEF_AWF : typeof awf === 'object' ? { ...DEF_AWF, ...awf } : false,
|
---|
254 | };
|
---|
255 | // Always default to polling on IBM i because fs.watch() is not available on IBM i.
|
---|
256 | if (handler_js_1.isIBMi)
|
---|
257 | opts.usePolling = true;
|
---|
258 | // Editor atomic write normalization enabled by default with fs.watch
|
---|
259 | if (opts.atomic === undefined)
|
---|
260 | opts.atomic = !opts.usePolling;
|
---|
261 | // opts.atomic = typeof _opts.atomic === 'number' ? _opts.atomic : 100;
|
---|
262 | // Global override. Useful for developers, who need to force polling for all
|
---|
263 | // instances of chokidar, regardless of usage / dependency depth
|
---|
264 | const envPoll = process.env.CHOKIDAR_USEPOLLING;
|
---|
265 | if (envPoll !== undefined) {
|
---|
266 | const envLower = envPoll.toLowerCase();
|
---|
267 | if (envLower === 'false' || envLower === '0')
|
---|
268 | opts.usePolling = false;
|
---|
269 | else if (envLower === 'true' || envLower === '1')
|
---|
270 | opts.usePolling = true;
|
---|
271 | else
|
---|
272 | opts.usePolling = !!envLower;
|
---|
273 | }
|
---|
274 | const envInterval = process.env.CHOKIDAR_INTERVAL;
|
---|
275 | if (envInterval)
|
---|
276 | opts.interval = Number.parseInt(envInterval, 10);
|
---|
277 | // This is done to emit ready only once, but each 'add' will increase that?
|
---|
278 | let readyCalls = 0;
|
---|
279 | this._emitReady = () => {
|
---|
280 | readyCalls++;
|
---|
281 | if (readyCalls >= this._readyCount) {
|
---|
282 | this._emitReady = handler_js_1.EMPTY_FN;
|
---|
283 | this._readyEmitted = true;
|
---|
284 | // use process.nextTick to allow time for listener to be bound
|
---|
285 | process.nextTick(() => this.emit(handler_js_1.EVENTS.READY));
|
---|
286 | }
|
---|
287 | };
|
---|
288 | this._emitRaw = (...args) => this.emit(handler_js_1.EVENTS.RAW, ...args);
|
---|
289 | this._boundRemove = this._remove.bind(this);
|
---|
290 | this.options = opts;
|
---|
291 | this._nodeFsHandler = new handler_js_1.NodeFsHandler(this);
|
---|
292 | // You’re frozen when your heart’s not open.
|
---|
293 | Object.freeze(opts);
|
---|
294 | }
|
---|
295 | _addIgnoredPath(matcher) {
|
---|
296 | if (isMatcherObject(matcher)) {
|
---|
297 | // return early if we already have a deeply equal matcher object
|
---|
298 | for (const ignored of this._ignoredPaths) {
|
---|
299 | if (isMatcherObject(ignored) &&
|
---|
300 | ignored.path === matcher.path &&
|
---|
301 | ignored.recursive === matcher.recursive) {
|
---|
302 | return;
|
---|
303 | }
|
---|
304 | }
|
---|
305 | }
|
---|
306 | this._ignoredPaths.add(matcher);
|
---|
307 | }
|
---|
308 | _removeIgnoredPath(matcher) {
|
---|
309 | this._ignoredPaths.delete(matcher);
|
---|
310 | // now find any matcher objects with the matcher as path
|
---|
311 | if (typeof matcher === 'string') {
|
---|
312 | for (const ignored of this._ignoredPaths) {
|
---|
313 | // TODO (43081j): make this more efficient.
|
---|
314 | // probably just make a `this._ignoredDirectories` or some
|
---|
315 | // such thing.
|
---|
316 | if (isMatcherObject(ignored) && ignored.path === matcher) {
|
---|
317 | this._ignoredPaths.delete(ignored);
|
---|
318 | }
|
---|
319 | }
|
---|
320 | }
|
---|
321 | }
|
---|
322 | // Public methods
|
---|
323 | /**
|
---|
324 | * Adds paths to be watched on an existing FSWatcher instance.
|
---|
325 | * @param paths_ file or file list. Other arguments are unused
|
---|
326 | */
|
---|
327 | add(paths_, _origAdd, _internal) {
|
---|
328 | const { cwd } = this.options;
|
---|
329 | this.closed = false;
|
---|
330 | this._closePromise = undefined;
|
---|
331 | let paths = unifyPaths(paths_);
|
---|
332 | if (cwd) {
|
---|
333 | paths = paths.map((path) => {
|
---|
334 | const absPath = getAbsolutePath(path, cwd);
|
---|
335 | // Check `path` instead of `absPath` because the cwd portion can't be a glob
|
---|
336 | return absPath;
|
---|
337 | });
|
---|
338 | }
|
---|
339 | paths.forEach((path) => {
|
---|
340 | this._removeIgnoredPath(path);
|
---|
341 | });
|
---|
342 | this._userIgnored = undefined;
|
---|
343 | if (!this._readyCount)
|
---|
344 | this._readyCount = 0;
|
---|
345 | this._readyCount += paths.length;
|
---|
346 | Promise.all(paths.map(async (path) => {
|
---|
347 | const res = await this._nodeFsHandler._addToNodeFs(path, !_internal, undefined, 0, _origAdd);
|
---|
348 | if (res)
|
---|
349 | this._emitReady();
|
---|
350 | return res;
|
---|
351 | })).then((results) => {
|
---|
352 | if (this.closed)
|
---|
353 | return;
|
---|
354 | results.forEach((item) => {
|
---|
355 | if (item)
|
---|
356 | this.add(sysPath.dirname(item), sysPath.basename(_origAdd || item));
|
---|
357 | });
|
---|
358 | });
|
---|
359 | return this;
|
---|
360 | }
|
---|
361 | /**
|
---|
362 | * Close watchers or start ignoring events from specified paths.
|
---|
363 | */
|
---|
364 | unwatch(paths_) {
|
---|
365 | if (this.closed)
|
---|
366 | return this;
|
---|
367 | const paths = unifyPaths(paths_);
|
---|
368 | const { cwd } = this.options;
|
---|
369 | paths.forEach((path) => {
|
---|
370 | // convert to absolute path unless relative path already matches
|
---|
371 | if (!sysPath.isAbsolute(path) && !this._closers.has(path)) {
|
---|
372 | if (cwd)
|
---|
373 | path = sysPath.join(cwd, path);
|
---|
374 | path = sysPath.resolve(path);
|
---|
375 | }
|
---|
376 | this._closePath(path);
|
---|
377 | this._addIgnoredPath(path);
|
---|
378 | if (this._watched.has(path)) {
|
---|
379 | this._addIgnoredPath({
|
---|
380 | path,
|
---|
381 | recursive: true,
|
---|
382 | });
|
---|
383 | }
|
---|
384 | // reset the cached userIgnored anymatch fn
|
---|
385 | // to make ignoredPaths changes effective
|
---|
386 | this._userIgnored = undefined;
|
---|
387 | });
|
---|
388 | return this;
|
---|
389 | }
|
---|
390 | /**
|
---|
391 | * Close watchers and remove all listeners from watched paths.
|
---|
392 | */
|
---|
393 | close() {
|
---|
394 | if (this._closePromise) {
|
---|
395 | return this._closePromise;
|
---|
396 | }
|
---|
397 | this.closed = true;
|
---|
398 | // Memory management.
|
---|
399 | this.removeAllListeners();
|
---|
400 | const closers = [];
|
---|
401 | this._closers.forEach((closerList) => closerList.forEach((closer) => {
|
---|
402 | const promise = closer();
|
---|
403 | if (promise instanceof Promise)
|
---|
404 | closers.push(promise);
|
---|
405 | }));
|
---|
406 | this._streams.forEach((stream) => stream.destroy());
|
---|
407 | this._userIgnored = undefined;
|
---|
408 | this._readyCount = 0;
|
---|
409 | this._readyEmitted = false;
|
---|
410 | this._watched.forEach((dirent) => dirent.dispose());
|
---|
411 | this._closers.clear();
|
---|
412 | this._watched.clear();
|
---|
413 | this._streams.clear();
|
---|
414 | this._symlinkPaths.clear();
|
---|
415 | this._throttled.clear();
|
---|
416 | this._closePromise = closers.length
|
---|
417 | ? Promise.all(closers).then(() => undefined)
|
---|
418 | : Promise.resolve();
|
---|
419 | return this._closePromise;
|
---|
420 | }
|
---|
421 | /**
|
---|
422 | * Expose list of watched paths
|
---|
423 | * @returns for chaining
|
---|
424 | */
|
---|
425 | getWatched() {
|
---|
426 | const watchList = {};
|
---|
427 | this._watched.forEach((entry, dir) => {
|
---|
428 | const key = this.options.cwd ? sysPath.relative(this.options.cwd, dir) : dir;
|
---|
429 | const index = key || ONE_DOT;
|
---|
430 | watchList[index] = entry.getChildren().sort();
|
---|
431 | });
|
---|
432 | return watchList;
|
---|
433 | }
|
---|
434 | emitWithAll(event, args) {
|
---|
435 | this.emit(...args);
|
---|
436 | if (event !== handler_js_1.EVENTS.ERROR)
|
---|
437 | this.emit(handler_js_1.EVENTS.ALL, ...args);
|
---|
438 | }
|
---|
439 | // Common helpers
|
---|
440 | // --------------
|
---|
441 | /**
|
---|
442 | * Normalize and emit events.
|
---|
443 | * Calling _emit DOES NOT MEAN emit() would be called!
|
---|
444 | * @param event Type of event
|
---|
445 | * @param path File or directory path
|
---|
446 | * @param stats arguments to be passed with event
|
---|
447 | * @returns the error if defined, otherwise the value of the FSWatcher instance's `closed` flag
|
---|
448 | */
|
---|
449 | async _emit(event, path, stats) {
|
---|
450 | if (this.closed)
|
---|
451 | return;
|
---|
452 | const opts = this.options;
|
---|
453 | if (handler_js_1.isWindows)
|
---|
454 | path = sysPath.normalize(path);
|
---|
455 | if (opts.cwd)
|
---|
456 | path = sysPath.relative(opts.cwd, path);
|
---|
457 | const args = [event, path];
|
---|
458 | if (stats != null)
|
---|
459 | args.push(stats);
|
---|
460 | const awf = opts.awaitWriteFinish;
|
---|
461 | let pw;
|
---|
462 | if (awf && (pw = this._pendingWrites.get(path))) {
|
---|
463 | pw.lastChange = new Date();
|
---|
464 | return this;
|
---|
465 | }
|
---|
466 | if (opts.atomic) {
|
---|
467 | if (event === handler_js_1.EVENTS.UNLINK) {
|
---|
468 | this._pendingUnlinks.set(path, args);
|
---|
469 | setTimeout(() => {
|
---|
470 | this._pendingUnlinks.forEach((entry, path) => {
|
---|
471 | this.emit(...entry);
|
---|
472 | this.emit(handler_js_1.EVENTS.ALL, ...entry);
|
---|
473 | this._pendingUnlinks.delete(path);
|
---|
474 | });
|
---|
475 | }, typeof opts.atomic === 'number' ? opts.atomic : 100);
|
---|
476 | return this;
|
---|
477 | }
|
---|
478 | if (event === handler_js_1.EVENTS.ADD && this._pendingUnlinks.has(path)) {
|
---|
479 | event = args[0] = handler_js_1.EVENTS.CHANGE;
|
---|
480 | this._pendingUnlinks.delete(path);
|
---|
481 | }
|
---|
482 | }
|
---|
483 | if (awf && (event === handler_js_1.EVENTS.ADD || event === handler_js_1.EVENTS.CHANGE) && this._readyEmitted) {
|
---|
484 | const awfEmit = (err, stats) => {
|
---|
485 | if (err) {
|
---|
486 | event = args[0] = handler_js_1.EVENTS.ERROR;
|
---|
487 | args[1] = err;
|
---|
488 | this.emitWithAll(event, args);
|
---|
489 | }
|
---|
490 | else if (stats) {
|
---|
491 | // if stats doesn't exist the file must have been deleted
|
---|
492 | if (args.length > 2) {
|
---|
493 | args[2] = stats;
|
---|
494 | }
|
---|
495 | else {
|
---|
496 | args.push(stats);
|
---|
497 | }
|
---|
498 | this.emitWithAll(event, args);
|
---|
499 | }
|
---|
500 | };
|
---|
501 | this._awaitWriteFinish(path, awf.stabilityThreshold, event, awfEmit);
|
---|
502 | return this;
|
---|
503 | }
|
---|
504 | if (event === handler_js_1.EVENTS.CHANGE) {
|
---|
505 | const isThrottled = !this._throttle(handler_js_1.EVENTS.CHANGE, path, 50);
|
---|
506 | if (isThrottled)
|
---|
507 | return this;
|
---|
508 | }
|
---|
509 | if (opts.alwaysStat &&
|
---|
510 | stats === undefined &&
|
---|
511 | (event === handler_js_1.EVENTS.ADD || event === handler_js_1.EVENTS.ADD_DIR || event === handler_js_1.EVENTS.CHANGE)) {
|
---|
512 | const fullPath = opts.cwd ? sysPath.join(opts.cwd, path) : path;
|
---|
513 | let stats;
|
---|
514 | try {
|
---|
515 | stats = await (0, promises_1.stat)(fullPath);
|
---|
516 | }
|
---|
517 | catch (err) {
|
---|
518 | // do nothing
|
---|
519 | }
|
---|
520 | // Suppress event when fs_stat fails, to avoid sending undefined 'stat'
|
---|
521 | if (!stats || this.closed)
|
---|
522 | return;
|
---|
523 | args.push(stats);
|
---|
524 | }
|
---|
525 | this.emitWithAll(event, args);
|
---|
526 | return this;
|
---|
527 | }
|
---|
528 | /**
|
---|
529 | * Common handler for errors
|
---|
530 | * @returns The error if defined, otherwise the value of the FSWatcher instance's `closed` flag
|
---|
531 | */
|
---|
532 | _handleError(error) {
|
---|
533 | const code = error && error.code;
|
---|
534 | if (error &&
|
---|
535 | code !== 'ENOENT' &&
|
---|
536 | code !== 'ENOTDIR' &&
|
---|
537 | (!this.options.ignorePermissionErrors || (code !== 'EPERM' && code !== 'EACCES'))) {
|
---|
538 | this.emit(handler_js_1.EVENTS.ERROR, error);
|
---|
539 | }
|
---|
540 | return error || this.closed;
|
---|
541 | }
|
---|
542 | /**
|
---|
543 | * Helper utility for throttling
|
---|
544 | * @param actionType type being throttled
|
---|
545 | * @param path being acted upon
|
---|
546 | * @param timeout duration of time to suppress duplicate actions
|
---|
547 | * @returns tracking object or false if action should be suppressed
|
---|
548 | */
|
---|
549 | _throttle(actionType, path, timeout) {
|
---|
550 | if (!this._throttled.has(actionType)) {
|
---|
551 | this._throttled.set(actionType, new Map());
|
---|
552 | }
|
---|
553 | const action = this._throttled.get(actionType);
|
---|
554 | if (!action)
|
---|
555 | throw new Error('invalid throttle');
|
---|
556 | const actionPath = action.get(path);
|
---|
557 | if (actionPath) {
|
---|
558 | actionPath.count++;
|
---|
559 | return false;
|
---|
560 | }
|
---|
561 | // eslint-disable-next-line prefer-const
|
---|
562 | let timeoutObject;
|
---|
563 | const clear = () => {
|
---|
564 | const item = action.get(path);
|
---|
565 | const count = item ? item.count : 0;
|
---|
566 | action.delete(path);
|
---|
567 | clearTimeout(timeoutObject);
|
---|
568 | if (item)
|
---|
569 | clearTimeout(item.timeoutObject);
|
---|
570 | return count;
|
---|
571 | };
|
---|
572 | timeoutObject = setTimeout(clear, timeout);
|
---|
573 | const thr = { timeoutObject, clear, count: 0 };
|
---|
574 | action.set(path, thr);
|
---|
575 | return thr;
|
---|
576 | }
|
---|
577 | _incrReadyCount() {
|
---|
578 | return this._readyCount++;
|
---|
579 | }
|
---|
580 | /**
|
---|
581 | * Awaits write operation to finish.
|
---|
582 | * Polls a newly created file for size variations. When files size does not change for 'threshold' milliseconds calls callback.
|
---|
583 | * @param path being acted upon
|
---|
584 | * @param threshold Time in milliseconds a file size must be fixed before acknowledging write OP is finished
|
---|
585 | * @param event
|
---|
586 | * @param awfEmit Callback to be called when ready for event to be emitted.
|
---|
587 | */
|
---|
588 | _awaitWriteFinish(path, threshold, event, awfEmit) {
|
---|
589 | const awf = this.options.awaitWriteFinish;
|
---|
590 | if (typeof awf !== 'object')
|
---|
591 | return;
|
---|
592 | const pollInterval = awf.pollInterval;
|
---|
593 | let timeoutHandler;
|
---|
594 | let fullPath = path;
|
---|
595 | if (this.options.cwd && !sysPath.isAbsolute(path)) {
|
---|
596 | fullPath = sysPath.join(this.options.cwd, path);
|
---|
597 | }
|
---|
598 | const now = new Date();
|
---|
599 | const writes = this._pendingWrites;
|
---|
600 | function awaitWriteFinishFn(prevStat) {
|
---|
601 | (0, fs_1.stat)(fullPath, (err, curStat) => {
|
---|
602 | if (err || !writes.has(path)) {
|
---|
603 | if (err && err.code !== 'ENOENT')
|
---|
604 | awfEmit(err);
|
---|
605 | return;
|
---|
606 | }
|
---|
607 | const now = Number(new Date());
|
---|
608 | if (prevStat && curStat.size !== prevStat.size) {
|
---|
609 | writes.get(path).lastChange = now;
|
---|
610 | }
|
---|
611 | const pw = writes.get(path);
|
---|
612 | const df = now - pw.lastChange;
|
---|
613 | if (df >= threshold) {
|
---|
614 | writes.delete(path);
|
---|
615 | awfEmit(undefined, curStat);
|
---|
616 | }
|
---|
617 | else {
|
---|
618 | timeoutHandler = setTimeout(awaitWriteFinishFn, pollInterval, curStat);
|
---|
619 | }
|
---|
620 | });
|
---|
621 | }
|
---|
622 | if (!writes.has(path)) {
|
---|
623 | writes.set(path, {
|
---|
624 | lastChange: now,
|
---|
625 | cancelWait: () => {
|
---|
626 | writes.delete(path);
|
---|
627 | clearTimeout(timeoutHandler);
|
---|
628 | return event;
|
---|
629 | },
|
---|
630 | });
|
---|
631 | timeoutHandler = setTimeout(awaitWriteFinishFn, pollInterval);
|
---|
632 | }
|
---|
633 | }
|
---|
634 | /**
|
---|
635 | * Determines whether user has asked to ignore this path.
|
---|
636 | */
|
---|
637 | _isIgnored(path, stats) {
|
---|
638 | if (this.options.atomic && DOT_RE.test(path))
|
---|
639 | return true;
|
---|
640 | if (!this._userIgnored) {
|
---|
641 | const { cwd } = this.options;
|
---|
642 | const ign = this.options.ignored;
|
---|
643 | const ignored = (ign || []).map(normalizeIgnored(cwd));
|
---|
644 | const ignoredPaths = [...this._ignoredPaths];
|
---|
645 | const list = [...ignoredPaths.map(normalizeIgnored(cwd)), ...ignored];
|
---|
646 | this._userIgnored = anymatch(list, undefined);
|
---|
647 | }
|
---|
648 | return this._userIgnored(path, stats);
|
---|
649 | }
|
---|
650 | _isntIgnored(path, stat) {
|
---|
651 | return !this._isIgnored(path, stat);
|
---|
652 | }
|
---|
653 | /**
|
---|
654 | * Provides a set of common helpers and properties relating to symlink handling.
|
---|
655 | * @param path file or directory pattern being watched
|
---|
656 | */
|
---|
657 | _getWatchHelpers(path) {
|
---|
658 | return new WatchHelper(path, this.options.followSymlinks, this);
|
---|
659 | }
|
---|
660 | // Directory helpers
|
---|
661 | // -----------------
|
---|
662 | /**
|
---|
663 | * Provides directory tracking objects
|
---|
664 | * @param directory path of the directory
|
---|
665 | */
|
---|
666 | _getWatchedDir(directory) {
|
---|
667 | const dir = sysPath.resolve(directory);
|
---|
668 | if (!this._watched.has(dir))
|
---|
669 | this._watched.set(dir, new DirEntry(dir, this._boundRemove));
|
---|
670 | return this._watched.get(dir);
|
---|
671 | }
|
---|
672 | // File helpers
|
---|
673 | // ------------
|
---|
674 | /**
|
---|
675 | * Check for read permissions: https://stackoverflow.com/a/11781404/1358405
|
---|
676 | */
|
---|
677 | _hasReadPermissions(stats) {
|
---|
678 | if (this.options.ignorePermissionErrors)
|
---|
679 | return true;
|
---|
680 | return Boolean(Number(stats.mode) & 0o400);
|
---|
681 | }
|
---|
682 | /**
|
---|
683 | * Handles emitting unlink events for
|
---|
684 | * files and directories, and via recursion, for
|
---|
685 | * files and directories within directories that are unlinked
|
---|
686 | * @param directory within which the following item is located
|
---|
687 | * @param item base path of item/directory
|
---|
688 | */
|
---|
689 | _remove(directory, item, isDirectory) {
|
---|
690 | // if what is being deleted is a directory, get that directory's paths
|
---|
691 | // for recursive deleting and cleaning of watched object
|
---|
692 | // if it is not a directory, nestedDirectoryChildren will be empty array
|
---|
693 | const path = sysPath.join(directory, item);
|
---|
694 | const fullPath = sysPath.resolve(path);
|
---|
695 | isDirectory =
|
---|
696 | isDirectory != null ? isDirectory : this._watched.has(path) || this._watched.has(fullPath);
|
---|
697 | // prevent duplicate handling in case of arriving here nearly simultaneously
|
---|
698 | // via multiple paths (such as _handleFile and _handleDir)
|
---|
699 | if (!this._throttle('remove', path, 100))
|
---|
700 | return;
|
---|
701 | // if the only watched file is removed, watch for its return
|
---|
702 | if (!isDirectory && this._watched.size === 1) {
|
---|
703 | this.add(directory, item, true);
|
---|
704 | }
|
---|
705 | // This will create a new entry in the watched object in either case
|
---|
706 | // so we got to do the directory check beforehand
|
---|
707 | const wp = this._getWatchedDir(path);
|
---|
708 | const nestedDirectoryChildren = wp.getChildren();
|
---|
709 | // Recursively remove children directories / files.
|
---|
710 | nestedDirectoryChildren.forEach((nested) => this._remove(path, nested));
|
---|
711 | // Check if item was on the watched list and remove it
|
---|
712 | const parent = this._getWatchedDir(directory);
|
---|
713 | const wasTracked = parent.has(item);
|
---|
714 | parent.remove(item);
|
---|
715 | // Fixes issue #1042 -> Relative paths were detected and added as symlinks
|
---|
716 | // (https://github.com/paulmillr/chokidar/blob/e1753ddbc9571bdc33b4a4af172d52cb6e611c10/lib/nodefs-handler.js#L612),
|
---|
717 | // but never removed from the map in case the path was deleted.
|
---|
718 | // This leads to an incorrect state if the path was recreated:
|
---|
719 | // https://github.com/paulmillr/chokidar/blob/e1753ddbc9571bdc33b4a4af172d52cb6e611c10/lib/nodefs-handler.js#L553
|
---|
720 | if (this._symlinkPaths.has(fullPath)) {
|
---|
721 | this._symlinkPaths.delete(fullPath);
|
---|
722 | }
|
---|
723 | // If we wait for this file to be fully written, cancel the wait.
|
---|
724 | let relPath = path;
|
---|
725 | if (this.options.cwd)
|
---|
726 | relPath = sysPath.relative(this.options.cwd, path);
|
---|
727 | if (this.options.awaitWriteFinish && this._pendingWrites.has(relPath)) {
|
---|
728 | const event = this._pendingWrites.get(relPath).cancelWait();
|
---|
729 | if (event === handler_js_1.EVENTS.ADD)
|
---|
730 | return;
|
---|
731 | }
|
---|
732 | // The Entry will either be a directory that just got removed
|
---|
733 | // or a bogus entry to a file, in either case we have to remove it
|
---|
734 | this._watched.delete(path);
|
---|
735 | this._watched.delete(fullPath);
|
---|
736 | const eventName = isDirectory ? handler_js_1.EVENTS.UNLINK_DIR : handler_js_1.EVENTS.UNLINK;
|
---|
737 | if (wasTracked && !this._isIgnored(path))
|
---|
738 | this._emit(eventName, path);
|
---|
739 | // Avoid conflicts if we later create another file with the same name
|
---|
740 | this._closePath(path);
|
---|
741 | }
|
---|
742 | /**
|
---|
743 | * Closes all watchers for a path
|
---|
744 | */
|
---|
745 | _closePath(path) {
|
---|
746 | this._closeFile(path);
|
---|
747 | const dir = sysPath.dirname(path);
|
---|
748 | this._getWatchedDir(dir).remove(sysPath.basename(path));
|
---|
749 | }
|
---|
750 | /**
|
---|
751 | * Closes only file-specific watchers
|
---|
752 | */
|
---|
753 | _closeFile(path) {
|
---|
754 | const closers = this._closers.get(path);
|
---|
755 | if (!closers)
|
---|
756 | return;
|
---|
757 | closers.forEach((closer) => closer());
|
---|
758 | this._closers.delete(path);
|
---|
759 | }
|
---|
760 | _addPathCloser(path, closer) {
|
---|
761 | if (!closer)
|
---|
762 | return;
|
---|
763 | let list = this._closers.get(path);
|
---|
764 | if (!list) {
|
---|
765 | list = [];
|
---|
766 | this._closers.set(path, list);
|
---|
767 | }
|
---|
768 | list.push(closer);
|
---|
769 | }
|
---|
770 | _readdirp(root, opts) {
|
---|
771 | if (this.closed)
|
---|
772 | return;
|
---|
773 | const options = { type: handler_js_1.EVENTS.ALL, alwaysStat: true, lstat: true, ...opts, depth: 0 };
|
---|
774 | let stream = (0, readdirp_1.readdirp)(root, options);
|
---|
775 | this._streams.add(stream);
|
---|
776 | stream.once(handler_js_1.STR_CLOSE, () => {
|
---|
777 | stream = undefined;
|
---|
778 | });
|
---|
779 | stream.once(handler_js_1.STR_END, () => {
|
---|
780 | if (stream) {
|
---|
781 | this._streams.delete(stream);
|
---|
782 | stream = undefined;
|
---|
783 | }
|
---|
784 | });
|
---|
785 | return stream;
|
---|
786 | }
|
---|
787 | }
|
---|
788 | exports.FSWatcher = FSWatcher;
|
---|
789 | /**
|
---|
790 | * Instantiates watcher with paths to be tracked.
|
---|
791 | * @param paths file / directory paths
|
---|
792 | * @param options opts, such as `atomic`, `awaitWriteFinish`, `ignored`, and others
|
---|
793 | * @returns an instance of FSWatcher for chaining.
|
---|
794 | * @example
|
---|
795 | * const watcher = watch('.').on('all', (event, path) => { console.log(event, path); });
|
---|
796 | * watch('.', { atomic: true, awaitWriteFinish: true, ignored: (f, stats) => stats?.isFile() && !f.endsWith('.js') })
|
---|
797 | */
|
---|
798 | function watch(paths, options = {}) {
|
---|
799 | const watcher = new FSWatcher(options);
|
---|
800 | watcher.add(paths);
|
---|
801 | return watcher;
|
---|
802 | }
|
---|
803 | exports.default = { watch, FSWatcher };
|
---|
804 | //# sourceMappingURL=index.js.map |
---|