Tester di pattern glob
Pattern glob
Percorsi
Risultati
Riepilogo della sintassi
- *
- Qualsiasi carattere all’interno di un segmento di percorso (non corrisponde a /)
- **
- Qualsiasi numero di segmenti di percorso, anche nessuno
- ?
- Esattamente un carattere (non /)
- [abc]
- Un carattere dell’insieme; [a-z] per un intervallo, [!abc] per negare
- {a,b}
- Alternative, ad es. *.{ts,tsx}, o intervalli come {1..3}
- !(x)
- Tutto tranne le alternative elencate, ad es. !(*.test).ts
- +(x)
- Una o più delle alternative elencate, ad es. +(a|b)
- @(x)
- Esattamente una delle alternative elencate, ad es. @(js|ts)
Dettagli tecnici
Come funziona il tester di pattern glob
Cosa fa lo strumento
Il tester di pattern glob verifica uno o più pattern glob su un elenco di percorsi di file e contrassegna ogni percorso come corrispondente o non corrispondente. I pattern vengono valutati in ordine, in stile gitignore: un pattern che inizia con ! rimuove percorsi dal risultato e i pattern successivi sovrascrivono quelli precedenti. Ogni risultato mostra quale pattern ha preso la decisione finale e puoi ispezionare l’espressione regolare che picomatch compila per ogni pattern. Tutto viene eseguito nel browser.
Casi d’uso comuni per gli sviluppatori
Gli sviluppatori usano i tester glob per fare il debug delle liste di inclusione ed esclusione in tsconfig.json, nei file ignore di ESLint e Prettier, nei pattern di test di Jest e Vitest, nei filtri di percorso di GitHub Actions, nella configurazione dei bundler e nelle chiavi di cache della CI. È utile anche per controllare le regole di .gitignore e .dockerignore prima del commit e per capire perché uno strumento di build include, o salta silenziosamente, un determinato file.
Formati di dati, tipi o varianti
La modalità predefinita usa picomatch, il matcher alla base di micromatch e di molti strumenti di build, con supporto per i caratteri jolly * e **, il carattere singolo ?, le classi di caratteri [abc], le alternative con parentesi graffe {a,b} e gli extglob come !(x), +(x) e @(x). La modalità opzionale .gitignore aggiunge le regole di gitignore: i pattern senza barra corrispondono a qualsiasi profondità, una barra iniziale ancora alla radice e una barra finale corrisponde solo alle directory. I file .gitignore delle sottodirectory e la regola per cui un file non può essere reincluso se la directory padre è esclusa non sono modellati.
Insidie comuni e buone pratiche
I caratteri jolly non corrispondono ai dotfile a meno che l’opzione dot sia attiva o il punto sia scritto esplicitamente, quindi **/* salta .github e .env. * non attraversa mai una barra, quindi *.ts corrisponde solo ai file di primo livello; usa **/*.ts per qualsiasi profondità. L’ordine conta con la negazione: un pattern ! esclude solo i percorsi corrisposti da un pattern precedente. Il glob è sensibile alle maiuscole per impostazione predefinita e i vari strumenti (minimatch, micromatch, globbing della shell, .gitignore) hanno differenze sottili, quindi conferma i risultati nello strumento con cui effettui davvero il deploy.