full_changelog.md

Chokidar 3.5.1 (Jan 15, 2021)

• Fixes for symbolic links

Chokidar 3.5.0 (Jan 6, 2021)

• Support for ARM Macs with Apple Silicon.
• Fixes missing removal of symlinks when the target path was deleted (#1042)

Chokidar 3.4.3 (Oct 13, 2020)

• Circular symlinks that point to some parent directory are no longer watched. This prevents infinite loops.

Chokidar 3.4.2 (Aug 6, 2020)

• Fixes an ability to watch network drives on windows.

Chokidar 3.4.1 (Jul 16, 2020)

• Fixes a bug when after a watcher was closed, files were not watched properly on new watch.

Chokidar 3.4.0 (Apr 26, 2020)

• Support for directory-based symlinks.
• Fix a case on macos when replacing a file with a dir of the same name emitted invalid events.
• Fix error swallowing inside .on() event handlers
• Known issue: followSymlinks: false on macos still follows symlinked directories

Chokidar 3.3.0 (Nov 2, 2019)

• FSWatcher#close() method became async. This ensures IO operations are finished properly and fixes a few segfaulty crashes.

Chokidar 3.2.3 (Oct 28, 2019)

• Fix memory leaks for directories, which change a lot for a long time. This existed since 3.0
• Small code refactoring
• Bump node requirement from 8.0 to 8.10, since dependencies use features only present in 8.10 and higher.

Chokidar 3.2.2 (Oct 16, 2019)

• Fix "resource starved CPU prevents ready from happening" (#873) by fixing fsevents
• Improve low-level directory scan time by 50% by improving readdirp

Chokidar 3.2.1 (Oct 1, 2019)

• Decrease required node version in package.json from 8.16 to 8.0.

Chokidar 3.2.0 (Oct 1, 2019)

• Improve Linux RAM usage by 50%.
• Another fix for non-empty strings of #871
• Stability optimizations. Tight dep version management: switch from ^ to ~ for all dependencies.
• Windows glob fixes.

Chokidar 3.1.1 (Sep 19, 2019)

• Fixes "Expected pattern to be a non-empty string" (#871)

Chokidar 3.1.0 (Sep 16, 2019)

• Breaking: dotfiles are no longer filtered out by default. Use ignored option if needed.
• Increase initial scan speed on Linux by 30-50%, by getting rid of unnecessary realpath calls (#882)
• Fix .add() returning promise & other type issues.
• Improves typings for watched paths.

Chokidar 3.0.2 (Jul 7, 2019)

• Brings bigint support to stat outputs on windows.
• Fixes ready event emission for symlink directories.

Chokidar 3.0.1 (Jun 3, 2019)

• Fixes an issue when a node process was crashing after chokidar.close() call.

Chokidar 3.0.0 (Apr 30, 2019)

• Breaking: Node v8+ only
• Massive CPU & RAM consumption improvements. 17x package & deps size reduction

Chokidar 2.1.7 (Aug 21, 2019)

• Fix fsevents v2 interoperability. Chokidar won't start fsevents if they're v2 in node_modules.

Chokidar 2.1.6 (May 15, 2019)

• Fix watcher.close() preventing process from exitting when watching globs

Chokidar 2.1.4 (Mar 22, 2019)

• Improve TypeScript type definitions for on method.

Chokidar 2.1.3 (Mar 22, 2019)

• Improve atomic writes handling

Chokidar 2.1.2 (Feb 18, 2019)

• Add TypeScript type definitions
• More fixes for accessTime behavior (#800)

Chokidar 2.1.1 (Feb 8, 2019)

• Handle simultaneous change of LastAccessTime and ModifiedTime (#793)

Chokidar 2.1.0 (Feb 5, 2019)

• Ignore accessTime updates caused by read operations (#762).
• Updated dependencies. Removed lodash.debounce.

Chokidar 2.0.4 (Jun 18, 2018)

• Prevent watcher.close() from crashing (#730).

Chokidar 2.0.3 (Mar 22, 2018)

• Fixes an issue that using fd = 0 is not closed in case Windows is used and a EPERM error is triggered.

Chokidar 2.0.2 (Feb 14, 2018)

• Allow semver range updates for upath dependency

Chokidar 2.0.1 (Feb 8, 2018)

• Fix #668 glob issue on Windows when using ignore and cwd. Thanks @remy!
• Fix #546 possible uncaught exception when using awaitWriteFinish. Thanks @dsagal!

Chokidar 2.0.0 (Dec 29, 2017)

• Breaking: Upgrade globbing dependencies which require globs to be more strict and always use POSIX-style slashes because Windows-style slashes are used as escape sequences
• Update tests to work with upgraded globbing dependencies
• Add ability to log FSEvents require error by setting CHOKIDAR_PRINT_FSEVENTS_REQUIRE_ERROR env
• Fix for handling braces in globs
• Add node 8 & 9 to CI configs
• Allow node 0.10 failures on Windows

Chokidar 1.7.0 (May 8, 2017)

• Add disableGlobbing option
• Add ability to force interval value by setting CHOKIDAR_INTERVAL env variable
• Fix issue with .close() being called before ready

Chokidar 1.6.0 (Jun 22, 2016)

• Added ability for force usePolling mode by setting CHOKIDAR_USEPOLLING env variable

Chokidar 1.5.2 (Jun 7, 2016)

• Fix missing addDir events when using cwd and alwaysStat options
• Fix missing add events for files within a renamed directory

Chokidar 1.5.1 (May 20, 2016)

• To help prevent exhaustion of FSEvents system limitations, consolidate watch instances to the common parent upon detection of separate watch instances on many siblings

Chokidar 1.5.0 (May 10, 2016)

• Make debounce delay setting used with atomic: true user-customizable
• Fixes and improvements to awaitWriteFinish features

Chokidar 1.4.3 (Feb 26, 2016)

• Update async-each dependency to ^1.0.0

Chokidar 1.4.2 (Dec 30, 2015)

• Now correctly emitting stats with awaitWriteFinish option.

Chokidar 1.4.1 (Dec 9, 2015)

• The watcher could now be correctly subclassed with ES6 class syntax.

Chokidar 1.4.0 (Dec 3, 2015)

• Add .getWatched() method, exposing all file system entries being watched
• Apply awaitWriteFinish methodology to change events (in addition to add)
• Fix handling of symlinks within glob paths (#293)
• Fix addDir and unlinkDir events under globs (#337, #401)
• Fix issues with .unwatch() (#374, #403)

Chokidar 1.3.0 (Nov 18, 2015)

• Improve awaitWriteFinish option behavior
• Fix some cwd option behavior on Windows
• awaitWriteFinish and cwd are now compatible
• Fix some race conditions.
• #379: Recreating deleted directory doesn't trigger event
• When adding a previously-deleted file, emit 'add', not 'change'

Chokidar 1.2.0 (Oct 1, 2015)

• Allow nested arrays of paths to be provided to .watch() and .add()
• Add awaitWriteFinish option

Chokidar 1.1.0 (Sep 23, 2015)

• Dependency updates including fsevents@1.0.0, improving installation

Chokidar 1.0.6 (Sep 18, 2015)

• Fix issue with .unwatch() method and relative paths

Chokidar 1.0.5 (Jul 20, 2015)

• Fix regression with regexes/fns using in ignored

Chokidar 1.0.4 (Jul 15, 2015)

• Fix bug with ignored files/globs while cwd option is set

Chokidar 1.0.3 (Jun 4, 2015)

• Fix race issue with alwaysStat option and removed files

Chokidar 1.0.2 (May 30, 2015)

• Fix bug with absolute paths and ENAMETOOLONG error

Chokidar 1.0.1 (Apr 8, 2015)

• Fix bug with .close() method in fs.watch mode with persistent: false option

Chokidar 1.0.0 (Apr 7, 2015)

• Glob support! Use globs in watch, add, and unwatch methods
• Comprehensive symlink support
• New unwatch method to turn off watching of previously watched paths
• More flexible ignored option allowing regex, function, glob, or array courtesy of anymatch
• New cwd option to set base dir from which relative paths are derived
• New depth option for limiting recursion
• New alwaysStat option to ensure fs.Stats gets passed with every add/change event
• New ready event emitted when initial fs tree scan is done and watcher is ready for changes
• New raw event exposing data and events from the lower-level watch modules
• New followSymlinks option to impact whether symlinks' targets or the symlink files themselves are watched
• New atomic option for normalizing artifacts from text editors that use atomic write methods
• Ensured watcher's stability with lots of bugfixes.

Chokidar 0.12.6 (Jan 6, 2015)

• Fix bug which breaks persistent: false mode when change events occur

Chokidar 0.12.5 (Dec 17, 2014)

• Fix bug with matching parent path detection for fsevents instance sharing
• Fix bug with ignored watch path in nodefs modes

Chokidar 0.12.4 (Dec 14, 2014)

• Fix bug in fs.watch mode that caused watcher to leak into cwd
• Fix bug preventing ready event when there are symlinks to ignored paths

Chokidar 0.12.3 (Dec 13, 2014)

• Fix handling of special files such as named pipes and sockets

Chokidar 0.12.2 (Dec 12, 2014)

• Fix recursive symlink handling and some other path resolution problems

Chokidar 0.12.1 (Dec 10, 2014)

• Fix a case where file symlinks were not followed properly

Chokidar 0.12.0 (Dec 8, 2014)

• Symlink support
  • Add followSymlinks option, which defaults to true
• Change default watch mode on Linux to non-polling fs.watch
• Add atomic option to normalize events from editors using atomic writes
  • Particularly Vim and Sublime
• Add raw event which exposes data from the underlying watch method

Chokidar 0.11.1 (Nov 19, 2014)

• Fix a bug where an error is thrown when fs.watch instantiation fails

Chokidar 0.11.0 (Nov 16, 2014)

• Add a ready event, which is emitted after initial file scan completes
• Fix issue with options keys passed in defined as undefined
• Rename some internal FSWatcher properties to indicate they're private

Chokidar 0.10.9 (Nov 15, 2014)

• Fix some leftover issues from adding watcher reuse

Chokidar 0.10.8 (Nov 14, 2014)

• Remove accidentally committed/published console.log statement.
• Sry 'bout that 😿

Chokidar 0.10.7 (Nov 14, 2014)

• Apply watcher reuse methodology to fs.watch and fs.watchFile as well

Chokidar 0.10.6 (Nov 12, 2014)

• More efficient creation/reuse of FSEvents instances to avoid system limits
• Reduce simultaneous FSEvents instances allowed in a process
• Handle errors thrown by fs.watch upon invocation

Chokidar 0.10.5 (Nov 6, 2014)

• Limit number of simultaneous FSEvents instances (fall back to other methods)
• Prevent some cases of EMFILE errors during initialization
• Fix ignored files emitting events in some fsevents-mode circumstances

Chokidar 0.10.4 (Nov 5, 2014)

• Bump fsevents dependency to ~0.3.1
  • Should resolve build warnings and npm rebuild on non-Macs

Chokidar 0.10.3 (Oct 28, 2014)

• Fix removed dir emitting as unlink instead of unlinkDir
• Fix issues with file changing to dir or vice versa (gh-165)
• Fix handling of ignored option in fsevents mode

Chokidar 0.10.2 (Oct 23, 2014)

• Improve individual file watching
• Fix fsevents keeping process alive when persistent: false

Chokidar 0.10.1 (19 October 2014)

• Improve handling of text editor atomic writes

Chokidar 0.10.0 (Oct 18, 2014)

• Many stability and consistency improvements
• Resolve many cases of duplicate or wrong events
• Correct for fsevents inconsistencies
• Standardize handling of errors and relative paths
• Fix issues with watching ./

Chokidar 0.9.0 (Sep 25, 2014)

• Updated fsevents to 0.3
• Update per-system defaults
• Fix issues with closing chokidar instance
• Fix duplicate change events on win32

Chokidar 0.8.2 (Mar 26, 2014)

• Fixed npm issues related to fsevents dep.
• Updated fsevents to 0.2.

Chokidar 0.8.1 (Dec 16, 2013)

• Optional deps are now truly optional on windows and linux.
• Rewritten in JS, again.
• Fixed some FSEvents-related bugs.

Chokidar 0.8.0 (Nov 29, 2013)

• Added ultra-fast low-CPU OS X file watching with FSEvents. It is enabled by default.
• Added addDir and unlinkDir events.
• Polling is now disabled by default on all platforms.

Chokidar 0.7.1 (Nov 18, 2013)

• Watcher#close now also removes all event listeners.

Chokidar 0.7.0 (Oct 22, 2013)

• When options.ignored is two-argument function, it will also be called after stating the FS, with stats argument.
• unlink is no longer emitted on directories.

Chokidar 0.6.3 (Aug 12, 2013)

• Added usePolling option (default: true). When false, chokidar will use fs.watch as backend. fs.watch is much faster, but not like super reliable.

Chokidar 0.6.2 (Mar 19, 2013)

• Fixed watching initially empty directories with ignoreInitial option.

Chokidar 0.6.1 (Mar 19, 2013)

• Added node.js 0.10 support.

Chokidar 0.6.0 (Mar 10, 2013)

• File attributes (stat()) are now passed to add and change events as second arguments.
• Changed default polling interval for binary files to 300ms.

Chokidar 0.5.3 (Jan 13, 2013)

• Removed emitting of change events before unlink.

Chokidar 0.5.2 (Jan 13, 2013)

• Removed postinstall script to prevent various npm bugs.

Chokidar 0.5.1 (Jan 6, 2013)

• When starting to watch non-existing paths, chokidar will no longer throw ENOENT error.
• Fixed bug with absolute path.

Chokidar 0.5.0 (Dec 9, 2012)

• Added a bunch of new options:
  • ignoreInitial that allows to ignore initial add events.
  • ignorePermissionErrors that allows to ignore ENOENT etc perm errors.
  • interval and binaryInterval that allow to change default fs polling intervals.

Chokidar 0.4.0 (Jul 26, 2012)

• Added all event that receives two args (event name and path) that combines add, change and unlink events.
• Switched to fs.watchFile on node.js 0.8 on windows.
• Files are now correctly unwatched after unlink.

Chokidar 0.3.0 (Jun 24, 2012)

• unlink event are no longer emitted for directories, for consistency with add.

Chokidar 0.2.6 (Jun 8, 2012)

• Prevented creating of duplicate 'add' events.

Chokidar 0.2.5 (Jun 8, 2012)

• Fixed a bug when new files in new directories hadn't been added.

Chokidar 0.2.4 (Jun 7, 2012)

• Fixed a bug when unlinked files emitted events after unlink.

Chokidar 0.2.3 (May 12, 2012)

• Fixed watching of files on windows.

Chokidar 0.2.2 (May 4, 2012)

• Fixed watcher signature.

Chokidar 0.2.1 (May 4, 2012)

• Fixed invalid API bug when using watch().

Chokidar 0.2.0 (May 4, 2012)

• Rewritten in js.

Chokidar 0.1.1 (Apr 26, 2012)

• Changed api to chokidar.watch().
• Fixed compilation on windows.

Chokidar 0.1.0 (Apr 20, 2012)

• Initial release, extracted from Brunch