Tester de șabloane glob
Șabloane glob
Căi
Rezultate
Memento de sintaxă
- *
- Orice caractere într-un singur segment de cale (nu se potrivește cu /)
- **
- Orice număr de segmente de cale, inclusiv niciunul
- ?
- Exact un caracter (nu /)
- [abc]
- Un caracter din set; [a-z] pentru un interval, [!abc] pentru negare
- {a,b}
- Alternative, de ex. *.{ts,tsx}, sau intervale precum {1..3}
- !(x)
- Orice, cu excepția alternativelor listate, de ex. !(*.test).ts
- +(x)
- Una sau mai multe dintre alternativele listate, de ex. +(a|b)
- @(x)
- Exact una dintre alternativele listate, de ex. @(js|ts)
Detalii tehnice
Cum funcționează testerul de șabloane glob
Ce face acest instrument
Testerul de șabloane glob verifică unul sau mai multe șabloane glob pe o listă de căi de fișiere și marchează fiecare cale ca potrivită sau nepotrivită. Șabloanele sunt evaluate în ordine, în stil gitignore: un șablon care începe cu ! elimină căi din rezultat, iar șabloanele ulterioare le suprascriu pe cele anterioare. Fiecare rezultat arată ce șablon a luat decizia finală și puteți inspecta expresia regulată pe care picomatch o compilează pentru fiecare șablon. Totul rulează în browser.
Cazuri de utilizare frecvente pentru dezvoltatori
Dezvoltatorii folosesc testere glob pentru a depana listele include și exclude din tsconfig.json, fișierele ignore ale ESLint și Prettier, șabloanele de teste Jest și Vitest, filtrele de căi din GitHub Actions, configurația bundlerelor și cheile de cache din CI. Este util și pentru a verifica regulile .gitignore și .dockerignore înainte de commit și pentru a înțelege de ce un instrument de build preia sau omite în tăcere un anumit fișier.
Formate de date, tipuri sau variante
Modul implicit folosește picomatch, motorul de potrivire din spatele micromatch și al multor instrumente de build, cu suport pentru metacaracterele * și **, ? pentru un singur caracter, clasele de caractere [abc], alternativele cu acolade {a,b} și extglob-urile !(x), +(x) și @(x). Modul opțional .gitignore adaugă regulile gitignore: șabloanele fără bară oblică se potrivesc la orice adâncime, o bară oblică la început ancorează la rădăcină, iar una la sfârșit se potrivește doar cu directoare. Fișierele .gitignore din subdirectoare și regula că un fișier nu poate fi reinclus după ce directorul părinte a fost exclus nu sunt modelate.
Capcane frecvente și bune practici
Metacaracterele nu se potrivesc cu fișierele cu punct la început decât dacă opțiunea dot este activată sau punctul este scris explicit, deci **/* omite .github și .env. * nu traversează niciodată o bară oblică, așa că *.ts se potrivește doar cu fișierele de la nivelul superior; folosiți **/*.ts pentru orice adâncime. Ordinea contează la negație: un șablon ! exclude doar căile potrivite de un șablon anterior. Potrivirea glob diferențiază implicit majusculele de minuscule, iar instrumentele diferite (minimatch, micromatch, globbing din shell, .gitignore) au diferențe subtile, deci confirmați rezultatele în instrumentul cu care faceți efectiv deploy.