Readdirp

대규모 디렉터리를 효율적으로 읽기 위한 Node.js용 리더

About

중첩된 디렉터리 전체를 재귀적으로 읽기 위해 설계된 도구로, fs.readdir 기반의 한계를 보완
Stream API를 중심으로 설계되어, 대규모 파일 트리에서도 낮은 RAM·CPU 사용량 유지
- for-await 패턴과 이벤트 기반 스트림 모두 지원
필요에 따라 Promise API도 제공하지만, 스트림 방식 대비 메모리·CPU 사용량 증가
파일과 디렉터리를 세밀하게 제어하기 위한 fileFilter / directoryFilter 제공
- 특정 확장자만 포함하거나, .git 같은 디렉터리 제외 가능
depth 옵션을 통해 재귀 탐색 깊이 제한 가능
기본적으로 Dirent 기반 정보를 반환해 성능을 최적화하며, 필요 시 alwaysStat 옵션으로 fs.Stats 정보 제공
- 파일 크기·mtime 등이 필요한 경우에만 활성화 권장
심볼릭 링크 처리, 파일 타입 제어 등 실무 환경을 고려한 옵션 제공
chokidar 와 함께 사용 시, 파일 탐색과 변경 감지 역할을 명확히 분리한 워크플로 구성에 적합