Тестер шаблонов 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 для отладки списков include и exclude в 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, глоббинг оболочки, .gitignore) имеют тонкие отличия, поэтому подтверждайте результаты в том инструменте, с которым вы действительно деплоите.