Tester wzorców glob
Wzorce glob
Ścieżki
Wyniki
Ściąga ze składni
- *
- Dowolne znaki w obrębie jednego segmentu ścieżki (nie pasuje do /)
- **
- Dowolna liczba segmentów ścieżki, także zero
- ?
- Dokładnie jeden znak (nie /)
- [abc]
- Jeden znak ze zbioru; [a-z] dla zakresu, [!abc] dla negacji
- {a,b}
- Alternatywy, np. *.{ts,tsx}, lub zakresy, np. {1..3}
- !(x)
- Wszystko poza wymienionymi alternatywami, np. !(*.test).ts
- +(x)
- Jedna lub więcej wymienionych alternatyw, np. +(a|b)
- @(x)
- Dokładnie jedna z wymienionych alternatyw, np. @(js|ts)
Szczegóły techniczne
Jak działa tester wzorców glob
Co robi to narzędzie
Tester wzorców glob sprawdza jeden lub więcej wzorców glob na liście ścieżek plików i oznacza każdą ścieżkę jako dopasowaną lub niedopasowaną. Wzorce są oceniane po kolei, w stylu gitignore: wzorzec zaczynający się od ! usuwa ścieżki z wyniku, a późniejsze wzorce nadpisują wcześniejsze. Każdy wynik pokazuje, który wzorzec podjął ostateczną decyzję, a możesz też przejrzeć wyrażenie regularne, które picomatch kompiluje dla każdego wzorca. Wszystko działa w przeglądarce.
Typowe zastosowania dla programistów
Programiści używają testerów glob do debugowania list include i exclude w tsconfig.json, plikach ignorowania ESLint i Prettier, wzorcach testów Jest i Vitest, filtrach ścieżek GitHub Actions, konfiguracji bundlerów i kluczach cache CI. Przydaje się też do sprawdzania reguł .gitignore i .dockerignore przed commitem oraz do zrozumienia, dlaczego narzędzie budujące wybiera lub po cichu pomija dany plik.
Formaty danych, typy lub warianty
Tryb domyślny używa picomatch, dopasowywarki stojącej za micromatch i wieloma narzędziami budującymi, z obsługą symboli wieloznacznych * i **, ? dla pojedynczych znaków, klas znaków [abc], alternatyw w nawiasach klamrowych {a,b} oraz extglobów !(x), +(x) i @(x). Opcjonalny tryb .gitignore dodaje reguły gitignore: wzorce bez ukośnika pasują na dowolnej głębokości, początkowy ukośnik kotwiczy do katalogu głównego, a końcowy pasuje tylko do katalogów. Pliki .gitignore w podkatalogach i reguła, że pliku nie można ponownie włączyć, gdy jego katalog nadrzędny jest wykluczony, nie są modelowane.
Typowe pułapki i dobre praktyki
Symbole wieloznaczne nie pasują do plików z kropką, chyba że opcja dot jest włączona lub kropka jest zapisana jawnie, więc **/* pomija .github i .env. * nigdy nie przekracza ukośnika, więc *.ts pasuje tylko do plików na najwyższym poziomie; użyj **/*.ts dla dowolnej głębokości. Przy negacji liczy się kolejność: wzorzec ! wyklucza tylko ścieżki dopasowane przez wcześniejszy wzorzec. Dopasowanie glob domyślnie uwzględnia wielkość liter, a różne narzędzia (minimatch, micromatch, globbing powłoki, .gitignore) mają subtelne różnice, więc potwierdź wyniki w narzędziu, którego naprawdę używasz do wdrożeń.