Chokidar
lastmod 2026-11-16created 2026-01-054 edits
Chokidar는 Paul Miller가 만든 Node.js 파일 감시 라이브러리이다. Node 의 fs.watch 가 변경을 뜻이 불분명한 rename 으로 알리거나 한 번의 변경에 이벤트를 두 번 내고, 재귀 감시 동작이 플랫폼마다 다른 문제를 감춰 일관된 이벤트로 바꿔 준다. 2012년 빌드 도구 Brunch 용으로 만들었고, npm 에서 3천만 개가 넘는 프로젝트가 의존한다.
About
-
add,change,unlink,addDir,unlinkDir이벤트를 검증·중복 제거해 전달하고, 초기 스캔이 끝나면ready를 냄 - 기본은 네이티브
fs.watch라 CPU 를 적게 씀. NFS 같은 네트워크 파일 시스템에서는backend: 'polling'으로 stat 기반 폴링 - 어느 플랫폼에서나 재귀 감시.
depth제한,ignored경로 필터, 심볼릭 링크 추적 옵션 - 에디터의 atomic write(
atomic)와 큰 파일의 청크 쓰기(awaitWriteFinish)는 쓰기가 끝난 뒤에 이벤트를 냄 - v4 에서 glob 지원과 fsevents 의존성을 뺐고, v5(2025년 11월)부터 ESM 전용·Node.js 20 이상
- v6(2026년 10월)는 전면 재작성으로 macOS·Windows 에
fs.watch(recursive)백엔드를 새로 넣었고 Node.js 22.22 이상이 필요함 - 이름은 '파수꾼'을 뜻하는 힌디어 चौकीदार(chowkidar)에서 따옴
- MIT 라이선스