---
type: JS Module
title: walkDir.mjs
resource: npm/scripts/utils/walkDir.mjs
docgen:
  crc: f205f003
  model: omlx/gemma-4-e4b-it-OptiQ-4bit
  score: 100
---

Публічна функція `walkDir` здійснює рекурсивний пошук файлів у вказаному каталозі. Вона обходить файлову систему, ігноруючи каталоги `.git` та `node_modules`. Знаходячи кожен файл, вона передає його повний шлях у колбек для подальшої обробки. Компонент є read-only, тобто не виконує записів у файлову систему чи бази даних. При роботі з файловою системою він перехоплює помилки, забезпечуючи безпечну роботу без викидання винятків.

## Поведінка

1. Викликається функція walkDir для початку рекурсивного обходу каталогу.
2. Система розшифровує вхідний шлях до кореня обходу.
3. Система формує додаткові правила ігнорування на основі наданих шляхів.
4. Система завжди ігнорує каталоги .git та node_modules.
5. Система виконує пошук усіх файлів у каталозі, застосовуючи правила ігнорування, включаючи ті, що визначені в .gitignore.
6. У разі виникнення помилки під час пошуку, процес обходу припиняється без генерації винятку.
7. Для кожного знайденого файлу система викликає наданий колбек, передаючи йому повний абсолютний шлях до цього файлу.

## Публічний API

walkDir — рекурсивно переглядає файли та папки, ігноруючи ті, що вказані у файлі `.gitignore`.

## Гарантії поведінки

- Read-only: не виконує операцій запису (ФС/БД).
- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
- Свідомо пропускає шляхи: `.git`, `node_modules`.
