Тестер glob-шаблонів
Glob-шаблони
Шляхи
Результати
Шпаргалка із синтаксису
- *
- Будь-які символи в межах одного сегмента шляху (не збігається з /)
- **
- Будь-яка кількість сегментів шляху, зокрема жодного
- ?
- Рівно один символ (не /)
- [abc]
- Один символ із набору; [a-z] для діапазону, [!abc] для заперечення
- {a,b}
- Варіанти, напр. *.{ts,tsx}, або діапазони на кшталт {1..3}
- !(x)
- Усе, крім перелічених варіантів, напр. !(*.test).ts
- +(x)
- Один або кілька перелічених варіантів, напр. +(a|b)
- @(x)
- Рівно один із перелічених варіантів, напр. @(js|ts)
Технічні деталі
Як працює тестер glob-шаблонів
Що робить інструмент
Тестер glob-шаблонів перевіряє один чи кілька glob-шаблонів на списку шляхів до файлів і позначає кожен шлях як збігається чи ні. Шаблони обчислюються по порядку, у стилі gitignore: шаблон, що починається з !, вилучає шляхи з результату, а пізніші шаблони перекривають попередні. Кожен результат показує, який шаблон ухвалив остаточне рішення, а також можна переглянути регулярний вираз, який picomatch компілює для кожного шаблону. Усе працює у вашому браузері.
Типові сценарії для розробників
Розробники використовують тестери glob, щоб налагоджувати списки включення та виключення в tsconfig.json, файлах ігнорування ESLint і Prettier, шаблонах тестів Jest і Vitest, фільтрах шляхів GitHub Actions, конфігурації бандлерів і ключах кешу CI. Це також зручно для перевірки правил .gitignore і .dockerignore перед комітом та щоб зрозуміти, чому інструмент збірки підхоплює або мовчки пропускає певний файл.
Формати даних, типи та варіанти
Типовий режим використовує picomatch — зіставник, на якому працюють micromatch і багато інструментів збірки, — з підтримкою символів підстановки * і **, одного символу ?, класів символів [abc], варіантів у фігурних дужках {a,b} і extglob на кшталт !(x), +(x) та @(x). Необов’язковий режим .gitignore додає правила gitignore: шаблони без похилої риски збігаються на будь-якій глибині, початкова похила риска прив’язує до кореня, а кінцева збігається лише з каталогами. Файли .gitignore у підкаталогах і правило, що файл не можна повторно включити, якщо його батьківський каталог виключено, не моделюються.
Типові підводні камені та найкращі практики
Символи підстановки не збігаються з файлами з крапкою, доки не ввімкнено опцію dot або крапку не записано явно, тому **/* пропускає .github і .env. * ніколи не перетинає похилу риску, тож *.ts збігається лише з файлами верхнього рівня; для будь-якої глибини використовуйте **/*.ts. Порядок має значення із запереченням: шаблон ! виключає лише шляхи, що збіглися з попереднім шаблоном. Зіставлення glob за замовчуванням чутливе до регістру, а різні інструменти (minimatch, micromatch, glob в оболонці, .gitignore) мають тонкі відмінності, тому перевіряйте результати в інструменті, який ви справді використовуєте під час розгортання.