Chokidar is a minimal, efficient, cross-platform file watching library for Node.js, built on the core `fs` module. It turns low-level filesystem events into normalized add, change, and unlink events, with options for recursive watching, filtering, symlink handling, and support for atomic and chunked writes.
Project status
- Active maintenance: The repo shows a very recent upstream push (2026-05-12), and the project has recent version activity including a major update (5.0.0 in 2025-11-25), suggesting it is actively maintained rather than abandoned.
- Update cadence: The newest published update is 5.0.0 (2025-11-25), with prior updates in mid to late 2024 (4.0.2 and 4.0.3 in December 2024). This points to a roughly yearly major update rhythm, with smaller follow-ons not shown in the provided list.
AI summary generated Today
Recent updates
5.0.0
6 months agoChokidar 5.0.0 is a major release focused on switching the package to ESM-only and raising the minimum supported Node.js version to 20.19. It also includes a TypeScript typing precision pass, a small performance tweak around double-slash regex handling, and updates around readdirp being ESM-only v5.
BreakingSecurity4.0.3
12/18/2024Release 4.0.3 updates chokidar's TypeScript typings related to the arguments emitted by FSWatcher events. The release notes describe it as a fix to the TypeScript type of the emitted args, but the diff shows more specific type refactoring around error versus non-error payloads.
4.0.2
12/16/2024chokidar 4.0.2 includes a FreeBSD-related fix for “safe-edit” behavior, adjusts backend logic to address inode-change detection on FreeBSD, and removes build artifacts/references for sourcemaps. It also changes the TypeScript typing of the FSWatcher EventEmitter interface to strongly type event payloads.
Features4.0.1
9/22/2024Chokidar 4.0.1 is primarily presented as a TypeScript typing cleanup release. The code diff, however, shows a few runtime-relevant adjustments around path normalization/unification and watcher close promise handling, in addition to type-only changes.
4.0.0
9/13/2024Chokidar 4.0.0 is a major rewrite that removes glob support and the bundled fsevents implementation. It also converts the codebase to TypeScript and publishes as a hybrid CommonJS/ESM package with a higher minimum Node.js version requirement.
Breaking3.6.0
2/6/2024Release 3.6.0 primarily fixes chokidar's macOS fsevents behavior, including correcting the internal readyCount logic and handling the fsevents flag indicating that chokidar must scan subdirectories. It also updates the TypeScript definitions for FSWatcher to be compatible with Node.js versions 16 and above.
3.5.3
1/27/2022chokidar 3.5.3 includes TypeScript definition improvements and a fix for symlink handling when the symlink target no longer exists. It also updates CI to run dtslinting and refreshes the chokidar-cli link in the README.
3.5.2
6/15/2021Release 3.5.2 is documented as a small dependency bump to silence vulnerability warnings for glob-parent. However, the actual diff includes additional runtime behavior changes (IBM i polling default), logic changes in the fsevents symlink/path handling, and several other dependency and test-related updates that are not mentioned in the release notes.
3.5.1
1/24/2021Release 3.5.1 is described only as a small symlink fix. The code diff shows an internal change to how chokidar tracks symlink paths, plus additional test coverage for symlink folder behavior and circular symlink error handling.
3.5.0
1/6/2021Chokidar 3.5.0 adds support for ARM Macs with Apple Silicon. It also claims a fix for a bug where symlink state was not cleaned up when the target path was deleted (issue #1042).
Features