A native C++ Node module for querying and subscribing to filesystem events. Used by Parcel 2.
Last release 1 months ago
20 Jul 2026
Release timing varies
gaps range from 9 days to 12 months
Most releases are documented
notes for 8 of 9 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
17 releases · first in 2023
Release timeline
17 releases since 2023Releases
- 2.6.020 Jul 2026
Release notes
Open source →Adds support RegExp ignores in https://github.com/parcel-bundler/watcher/pull/248. Thanks @SimenB!
- 2.5.623 Jan 2026
Release notes
Open source →What's Changed
- chore: add stack-protector-strong flag by @rzhao271 in https://github.com/parcel-bundler/watcher/pull/236
- fix windows ia32 build by @bpasero in https://github.com/parcel-bundler/watcher/pull/237
- v2.5.6 by @bpasero in https://github.com/parcel-bundler/watcher/pull/238
Full Changelog: https://github.com/parcel-bundler/watcher/compare/v2.5.5...v2.5.6
- 2.5.411 Jan 2026
Release notes
Open source →What's Changed
- patch: fix SEGV due to Static Initialization Order Fiasco bug by @alichtman in https://github.com/parcel-bundler/watcher/pull/208
- Resolve several BinSkim issues by @rzhao271 in https://github.com/parcel-bundler/watcher/pull/202
- upgrade detect-libc for better compatibility by @nicksrandall in https://github.com/parcel-bundler/watcher/pull/200
- Don't show error messages when checking if watchman is available by @aptinio in https://github.com/parcel-bundler/watcher/pull/198
- Add Meteor to list of users by @harryadel in https://github.com/parcel-bundler/watcher/pull/214
- Fix CI by @tmm1 in https://github.com/parcel-bundler/watcher/pull/213
- Fix more SIOF / SDOF issues by @alichtman in https://github.com/parcel-bundler/watcher/pull/216
- Resolve more BinSkim issues by @rzhao271 in https://github.com/parcel-bundler/watcher/pull/219
- Remove
D_FORTIFY_SOURCEflag by @bpasero in https://github.com/parcel-bundler/watcher/pull/223 - Fix use of delete operators by @matttyson in https://github.com/parcel-bundler/watcher/pull/145
- Some minor fixes found doing code review by @bpasero in https://github.com/parcel-bundler/watcher/pull/222
- Reduce dependencies by switching to picomatch by @benmccann in https://github.com/parcel-bundler/watcher/pull/210
- Fix glob tests on windows by going back to
[email protected]by @bpasero in https://github.com/parcel-bundler/watcher/pull/224 - v2.5.2 by @bpasero in https://github.com/parcel-bundler/watcher/pull/225
- eng - update actions versions by @bpasero in https://github.com/parcel-bundler/watcher/pull/226
- v2.5.3 by @bpasero in https://github.com/parcel-bundler/watcher/pull/227
- Test on current versions of Node.js by @cclauss in https://github.com/parcel-bundler/watcher/pull/221
- eng - try to fix release script to publish new NPM version by @bpasero in https://github.com/parcel-bundler/watcher/pull/228
- v2.5.4 by @bpasero in https://github.com/parcel-bundler/watcher/pull/229
New Contributors
- @alichtman made their first contribution in https://github.com/parcel-bundler/watcher/pull/208
- @rzhao271 made their first contribution in https://github.com/parcel-bundler/watcher/pull/202
- @nicksrandall made their first contribution in https://github.com/parcel-bundler/watcher/pull/200
- @aptinio made their first contribution in https://github.com/parcel-bundler/watcher/pull/198
- @harryadel made their first contribution in https://github.com/parcel-bundler/watcher/pull/214
- @matttyson made their first contribution in https://github.com/parcel-bundler/watcher/pull/145
- @benmccann made their first contribution in https://github.com/parcel-bundler/watcher/pull/210
- @cclauss made their first contribution in https://github.com/parcel-bundler/watcher/pull/221
Full Changelog: https://github.com/parcel-bundler/watcher/compare/v2.5.1...v2.5.4
- 2.5.126 Jan 2025
Release notes
Open source →- Handle large changes from FS Events better in getEventsSince - #196
- Fix use after free in kqueue backend
- fix: catch std:regex error - #195
- 2.5.04 Nov 2024
Release notes
Open source →Added
- Support 32-bit arm musl platform
- Support npm
--build-from-sourceflag to optionally build from source instead of using prebuilt packages. Can be used in conjunction with--no-optionalto prevent installing platform-specific dependencies.
Fixed
- Fix use after free errors (#177)
- Fix deadlock between Watcher and Debounce threads (#189)
- Avoid
open()calls onstat()failures on macOS to prevent security dialogs (#186)
- 2.4.2-alpha.013 Jun 2024pre-release
Nothing published for this version
- 2.4.123 Feb 2024
Nothing published for this version
- 2.4.015 Jan 2024
Release notes
Open source →Adds support for CommonJS (along with existing support for ESM) in
@parcel/watcher-wasm. - 2.3.024 Aug 2023
Release notes
Open source →Features
- Add a kqueue backend to support FreeBSD, or as an alternative to FSEvents on macOS
- Add a WASM backend, for use in environments where native modules cannot run (e.g. on the web in environments like Stackblitz, or unsupported processor architectures/operating systems). Use the
@parcel/watcher-wasmpackage instead of@parcel/watcherin these cases. Note that this is much less efficient than using native OS-specific APIs, so keep using the native packages where possible. - Migrate to napi thread safe functions, which allows using
@parcel/watcherfrom multiple Node.js worker threads - Add a 32-bit windows build, useful if users accidentally installed a 32-bit version of Node
- 2.3.0-alpha.320 Aug 2023pre-release
Nothing published for this version
- 2.3.0-alpha.219 Aug 2023pre-release
Nothing published for this version
- 2.3.0-alpha.130 Jul 2023pre-release
Nothing published for this version
- 2.3.0-alpha.030 Jul 2023pre-release
Nothing published for this version
- 2.2.1-alpha.05 Jul 2023pre-release
Nothing published for this version
- 2.2.02 Jul 2023
Release notes
Open source →This release migrates to a new method of distribution. Rather than including binaries for all operating systems and architectures inside the
@parcel/watcherpackage, there are now individual packages per platform (e.g.@parcel/watcher-darwin-x64). Each of these is an optional dependency of the main watcher package. This way, npm and other package managers will install only the binary for the platform you are running on. This reduces bandwidth and disk space.This also enabled us to add pre-compiled binaries for more platforms, meaning you don't need to have a C++ compiler to install the watcher. This should help with some minimal Docker environments especially. The architectures with prebuilds available now include:
- darwin-x64
- darwin-arm64
- win32-x64
- win32-arm64
- linux-x64-glibc
- linux-x64-musl
- linux-arm64-glibc
- linux-arm64-musl
- linux-arm-glibc (32-bit arm v7)
- android-arm64
- 2.2.0-alpha.126 Jun 2023pre-release
Nothing published for this version
- 2.2.0-alpha.025 Jun 2023pre-release
Nothing published for this version