Testador de padrões glob
Padrões glob
Caminhos
Resultados
Resumo da sintaxe
- *
- Quaisquer caracteres dentro de um segmento de caminho (não corresponde a /)
- **
- Qualquer número de segmentos de caminho, inclusive nenhum
- ?
- Exatamente um caractere (não /)
- [abc]
- Um caractere do conjunto; [a-z] para um intervalo, [!abc] para negar
- {a,b}
- Alternativas, por exemplo *.{ts,tsx}, ou intervalos como {1..3}
- !(x)
- Qualquer coisa exceto as alternativas listadas, por exemplo !(*.test).ts
- +(x)
- Uma ou mais das alternativas listadas, por exemplo +(a|b)
- @(x)
- Exatamente uma das alternativas listadas, por exemplo @(js|ts)
Detalhes técnicos
Como funciona o testador de padrões glob
O que esta ferramenta faz
O testador de padrões glob verifica um ou mais padrões glob em uma lista de caminhos de arquivos e marca cada caminho como correspondente ou sem correspondência. Os padrões são avaliados em ordem, no estilo gitignore: um padrão iniciado por ! remove caminhos do resultado e padrões posteriores sobrescrevem os anteriores. Cada resultado mostra qual padrão tomou a decisão final, e você pode inspecionar a expressão regular que o picomatch compila para cada padrão. Tudo roda no seu navegador.
Casos de uso comuns para desenvolvedores
Desenvolvedores usam testadores de glob para depurar listas de include e exclude em tsconfig.json, arquivos de ignore do ESLint e do Prettier, padrões de teste do Jest e do Vitest, filtros de caminho do GitHub Actions, configuração de bundlers e chaves de cache de CI. Também é útil para conferir regras de .gitignore e .dockerignore antes de fazer commit e para entender por que uma ferramenta de build pega, ou ignora silenciosamente, um arquivo específico.
Formatos de dados, tipos ou variantes
O modo padrão usa o picomatch, o matcher por trás do micromatch e de muitas ferramentas de build, com suporte a curingas * e **, ? para um único caractere, classes de caracteres [abc], alternativas com chaves {a,b} e extglobs !(x), +(x) e @(x). O modo opcional .gitignore adiciona regras do gitignore: padrões sem barra correspondem em qualquer profundidade, uma barra inicial ancora na raiz e uma barra final corresponde apenas a diretórios. Arquivos .gitignore em subdiretórios e a regra de que um arquivo não pode ser reincluído quando o diretório pai é excluído não são modelados.
Armadilhas comuns e boas práticas
Curingas não correspondem a dotfiles, a menos que a opção dot esteja ativa ou o ponto seja escrito explicitamente, então **/* ignora .github e .env. * nunca atravessa uma barra, então *.ts corresponde apenas a arquivos de nível superior; use **/*.ts para qualquer profundidade. A ordem importa na negação: um padrão ! só exclui caminhos que um padrão anterior correspondeu. A correspondência glob diferencia maiúsculas de minúsculas por padrão, e ferramentas diferentes (minimatch, micromatch, globbing de shell, .gitignore) têm diferenças sutis, então confirme os resultados na ferramenta que você realmente usa no deploy.