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