Packages

chokidar

6.0.0 · 19 Oct 2026MIT292.3M / weekRepositorynpmAtom feed

Upgrading chokidar From 3.2.2 to 6.0.0

18 releases in betweenevery note read

Other targets from 3.2.2Newest 3.x3.6.0
  1. 3.2.2yours
  2. 9 releases
  3. 3.5.2security
  4. 2 releases
  5. 4.0.0major
  6. 3 releases
  7. 5.0.0major
  8. 6.0.0target

Before you upgrade

Tick each one off as you go
  • Breaking6.0.0
  • Breaking5.0.0
  • Breaking4.0.0

Security

  • "Update" glob-parent dependency from ~5.1.0 to ~5.1.2 to silence "vulnerability" warnings

    3.5.2

Release by release

  1. 6.0.0

    Migration needed19 Oct 20262 new · 24 fixes
    • Breaking

      Required Node.js 22.22 or later.

    • New

      Added native recursive watching through fs.watch({ recursive: true }). The default auto backend uses it on macOS and Windows and per-directory watching elsewhere.

    • New

      Added the backend option: 'auto' (default), 'native', 'native-recursive', or 'polling'.

    • Fixed

      Fixed a 100% CPU loop when the process working directory containing a relatively watched file was deleted (#1474).

  2. 5.0.0

    Migration needed25 Nov 20251 new · 1 fix
    • Breaking

      Increase minimum node.js version to v20.19. The versions starting from it support loading esm files from cjs

    • New

      re-use double slash regex #1435

    • Fixed

      Make types more precise #1424

  3. 4.0.3

    18 Dec 20241 fix
    • Fixed

      Fix typescript type of emitted args

  4. 4.0.2

    16 Dec 20241 new · 1 fix
    • New

      Strongly type event emitter methods

    • Fixed

      Fix test "should detect safe-edit" on FreeBSD

  5. 4.0.1nothing new or fixed in the note

  6. 4.0.0

    Migration needed13 Sep 2024
    • Breaking

      Bump minimum node.js requirement to v14+

  7. 3.6.0

    6 Feb 20242 fixes
    • Fixed

      Fix readyCount logic

    • Fixed

      Handle MustScanSubDirs

  8. 3.5.3

    18 Jan 20221 new · 2 fixes
    • New

      Enable dtslinting

    • Fixed

      Handle promise rejection when a symlink's target does not exist. Fixe…

    • Fixed

      Improve add and unwatch TypeScript definitions

30 other lines we could not sort, mostly version bumps
  • Rewrote the watcher around a single observation pipeline. Backend callbacks are treated as invalidations and confirmed with lstat, stat, or readdir before any event is emitted, so the final state after a burst of changes matches the filesystem.

    6.0.0
  • Shared native handles across watchers and opened them per directory only: files no longer own handles. This fixes EBADF errors when watching many files on macOS (#1385, #1452).

    6.0.0
  • Replaced fs.watchFile with Chokidar-owned stat polling. Poll loops are shared across watchers at the fastest requested interval.

    6.0.0
  • Renamed interval and binaryInterval to pollingInterval and pollingBinaryInterval.

    6.0.0
  • Changed the atomic default to false with polling. An explicit value is preserved.

    6.0.0
  • Made close() terminal: add() now throws once closing has started. Construct a new watcher instead.

    6.0.0
  • Validated options in the constructor: invalid backend, atomic, depth, awaitWriteFinish, and polling intervals throw TypeError.

    6.0.0
  • Emitted errors from add() as error events instead of unhandled rejections (#1378).

    6.0.0
  • Made getWatched() return a null-prototype object, so a watched directory named __proto__ is listed (#1493). Use Object.hasOwn() instead of hasOwnProperty() on the result.

    6.0.0
  • Stopped applying ignored to directories above a path passed to watch() or add(), so a missing path is still watched through its parent (#1374). Other entries in those directories are still filtered.

    6.0.0

3 internal lines (docs, tests, tooling) left out.

A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.