NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #83 most downloaded on npm
Minimal and efficient cross-platform file watching library
Latest stable
6.0.0
Last release 1 months ago
19 Oct 2026
Release timing varies
gaps range from 9 days to 2.1 years
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
15 years old
110 releases · first in 2012
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Fixed persistent: false mode breaking when change events occur.
persistent: false mode breaking when change events occur.Fixed parent path detection for FSEvents instance sharing.
Fixed the watcher leaking into cwd in fs.watch mode.
cwd in fs.watch mode.ready.Fixed handling of special files such as named pipes and sockets.
Fixed recursive symlink handling and other path resolution problems.
Fixed file symlinks not being followed properly.
Added symlink support with the followSymlinks option, which defaults to true.
followSymlinks option, which defaults to true.fs.watch.atomic option to normalize events from editors that use atomic writes, such as Vim and Sublime.raw event, exposing data from the underlying watch method.Fixed an error being thrown when fs.watch instantiation fails.
fs.watch instantiation fails.Added the ready event, emitted after the initial file scan.
ready event, emitted after the initial file scan.undefined.Fixed leftover issues from watcher reuse.
Removed an accidentally published console.log statement.
console.log statement.Applied watcher reuse to fs.watch and fs.watchFile.
fs.watch and fs.watchFile.Reused FSEvents instances more efficiently to avoid system limits.
fs.watch on invocation.Limited the number of simultaneous FSEvents instances, falling back to other methods.
EMFILE errors during initialization.Updated fsevents to ~0.3.1, resolving build warnings and npm rebuild on non-Macs.
~0.3.1, resolving build warnings and npm rebuild on non-Macs.Fixed removed directories being emitted as unlink instead of unlinkDir.
unlink instead of unlinkDir.ignored option in FSEvents mode.Improved watching of individual files.
persistent: false.Improved handling of text editor atomic writes.
Improved stability and consistency, resolving many duplicate or wrong events.
./.Updated fsevents to 0.3 and per-system defaults.
change events on Windows.- Fixed regressions from 0.8.3.
Allowed FSEvents when not on Windows and polling is not explicitly disabled, contributed by @wraithan in pull request #134.
ENOENT errors, contributed by @MichaelBailly in pull request #123.Updated fsevents to 0.2, fixing npm issues.
Made optional dependencies truly optional on Windows and Linux.
Added fast, low-CPU macOS watching with FSEvents, enabled by default.
addDir and unlinkDir events.Made close() also remove all event listeners.
close() also remove all event listeners.Called a two-argument ignored function again after stat, with the stats argument.
ignored function again after stat, with the stats argument.unlink for directories.Added the usePolling option (default: true). When false, chokidar uses fs.watch, which is much faster but less reliable.
usePolling option (default: true). When false, chokidar uses fs.watch, which is much faster but less reliable.Fixed watching initially empty directories with the ignoreInitial option.
ignoreInitial option.- Added Node.js 0.10 support.
Passed file attributes (stat()) to add and change events as the second argument.
stat()) to add and change events as the second argument.Stopped emitting change before unlink.
change before unlink.Removed the postinstall script to avoid npm bugs.
Stopped throwing ENOENT when watching paths that do not exist.
ENOENT when watching paths that do not exist.Added the ignoreInitial option to skip initial add events.
ignoreInitial option to skip initial add events.ignorePermissionErrors option.interval and binaryInterval options to change polling intervals.Added the all event, which receives the event name and path for add, change, and unlink.
all event, which receives the event name and path for add, change, and unlink.fs.watchFile on Node.js 0.8 on Windows.unlink.Stopped emitting unlink for directories, for consistency with add.
unlink for directories, for consistency with add.Prevented duplicate add events.
add events.Fixed new files in new directories not being added.
Fixed unlinked files emitting events after unlink.
unlink.Fixed watching files on Windows.
- Fixed the watcher signature.
Fixed an invalid API bug when using watch().
watch().Rewrote the package in JavaScript.
Changed the API to chokidar.watch().
chokidar.watch().One column per quarter.