Packages

chokidar

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

Upgrading chokidar From 1.0.4 to 6.0.0

55 releases in betweenevery note read

Other targets from 1.0.4Newest 1.x1.7.0
  1. 1.0.4yours
  2. 15 releases
  3. 2.0.0major
  4. 13 releases
  5. 3.0.0major
  6. 16 releases
  7. 3.5.2security
  8. 2 releases
  9. 4.0.0major
  10. 3 releases
  11. 5.0.0major
  12. 6.0.0target

Before you upgrade

Tick each one off as you go
  • Breaking6.0.0
  • Breaking5.0.0
  • Breaking4.0.0
  • Breaking2.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

50 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

5 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.