Testeur de motifs glob
Motifs glob
Chemins
Résultats
Aide-mémoire de la syntaxe
- *
- Tous caractères dans un seul segment de chemin (ne correspond pas à /)
- **
- Un nombre quelconque de segments de chemin, y compris aucun
- ?
- Exactement un caractère (pas /)
- [abc]
- Un caractère de l’ensemble ; [a-z] pour une plage, [!abc] pour la négation
- {a,b}
- Alternatives, p. ex. *.{ts,tsx}, ou plages comme {1..3}
- !(x)
- Tout sauf les alternatives listées, p. ex. !(*.test).ts
- +(x)
- Une ou plusieurs des alternatives listées, p. ex. +(a|b)
- @(x)
- Exactement une des alternatives listées, p. ex. @(js|ts)
Détails techniques
Comment fonctionne le testeur de motifs glob
Ce que fait l’outil
Le testeur de motifs glob vérifie un ou plusieurs motifs glob sur une liste de chemins de fichiers et marque chaque chemin comme correspondant ou non. Les motifs sont évalués dans l’ordre, à la manière de gitignore : un motif commençant par ! retire des chemins du résultat et les motifs suivants remplacent les précédents. Chaque résultat indique quel motif a pris la décision finale, et vous pouvez inspecter l’expression régulière que picomatch compile pour chaque motif. Tout s’exécute dans votre navigateur.
Cas d’usage courants pour les développeurs
Les développeurs utilisent des testeurs de glob pour déboguer les listes d’inclusion et d’exclusion dans tsconfig.json, les fichiers d’ignore d’ESLint et Prettier, les motifs de tests Jest et Vitest, les filtres de chemins GitHub Actions, la configuration des bundlers et les clés de cache CI. C’est aussi pratique pour vérifier les règles .gitignore et .dockerignore avant de valider, et pour comprendre pourquoi un outil de build prend en compte, ou ignore silencieusement, un fichier donné.
Formats, types ou variantes de données
Le mode par défaut utilise picomatch, le moteur derrière micromatch et de nombreux outils de build, avec prise en charge des jokers * et **, du caractère unique ?, des classes de caractères [abc], des alternatives avec accolades {a,b} et des extglobs comme !(x), +(x) et @(x). Le mode .gitignore optionnel ajoute les règles gitignore : les motifs sans barre oblique correspondent à n’importe quelle profondeur, une barre oblique initiale ancre à la racine et une barre oblique finale ne correspond qu’aux répertoires. Les fichiers .gitignore des sous-répertoires et la règle selon laquelle un fichier ne peut pas être réinclus si son répertoire parent est exclu ne sont pas modélisés.
Pièges courants et bonnes pratiques
Les jokers ne correspondent pas aux fichiers cachés sauf si l’option dot est activée ou si le point est écrit explicitement, donc **/* ignore .github et .env. * ne franchit jamais une barre oblique, donc *.ts ne correspond qu’aux fichiers de premier niveau ; utilisez **/*.ts pour toute profondeur. L’ordre compte avec la négation : un motif ! n’exclut que les chemins correspondant à un motif précédent. La correspondance glob est sensible à la casse par défaut, et les outils (minimatch, micromatch, glob du shell, .gitignore) ont des différences subtiles : confirmez donc les résultats dans l’outil avec lequel vous déployez réellement.