Glob パターンテスター
Glob パターン
パス
結果
構文チートシート
- *
- 1 つのパスセグメント内の任意の文字(/ にはマッチしません)
- **
- 0 個を含む任意の数のパスセグメント
- ?
- ちょうど 1 文字(/ を除く)
- [abc]
- セット内の 1 文字。範囲は [a-z]、否定は [!abc]
- {a,b}
- 選択肢の例: *.{ts,tsx}、または範囲 {1..3}
- !(x)
- 列挙した選択肢以外すべて。例: !(*.test).ts
- +(x)
- 列挙した選択肢の 1 つ以上。例: +(a|b)
- @(x)
- 列挙した選択肢のうちちょうど 1 つ。例: @(js|ts)
技術的な詳細
Glob パターンテスターの仕組み
このツールでできること
Glob パターンテスターは、1 つ以上の glob パターンをファイルパスの一覧に対してチェックし、各パスを一致または不一致として表示します。パターンは gitignore と同様に順番に評価されます。! で始まるパターンは結果からパスを取り除き、後のパターンが先のパターンを上書きします。各結果には最終的な判断を下したパターンが表示され、picomatch が各パターンからコンパイルした正規表現も確認できます。すべてブラウザー内で実行されます。
開発者の主な利用シーン
開発者は glob テスターを使って、tsconfig.json、ESLint や Prettier の ignore ファイル、Jest や Vitest のテストパターン、GitHub Actions のパスフィルター、バンドラーの設定、CI のキャッシュキーにおける include / exclude リストをデバッグします。コミット前に .gitignore や .dockerignore のルールを確認したり、ビルドツールが特定のファイルを取り込んだり、黙ってスキップしたりする理由を理解したりするのにも便利です。
データ形式、種類、バリエーション
既定のモードは picomatch を使います。picomatch は micromatch や多くのビルドツールの基盤となるマッチャーで、* と ** のワイルドカード、1 文字を表す ?、[abc] の文字クラス、{a,b} のブレース展開、!(x)、+(x)、@(x) などの extglob に対応します。オプションの .gitignore モードでは gitignore のルールが加わります。スラッシュを含まないパターンは任意の深さにマッチし、先頭のスラッシュはルートに固定され、末尾のスラッシュはディレクトリのみにマッチします。サブディレクトリの .gitignore ファイルと、親ディレクトリが除外されている場合にファイルを再度含めることはできないというルールは再現されません。
よくある落とし穴とベストプラクティス
ワイルドカードは、dot オプションがオンか、ドットが明示的に書かれていない限りドットファイルにマッチしないため、**/* は .github や .env をスキップします。* はスラッシュを越えないので、*.ts は最上位のファイルにしかマッチしません。任意の深さには **/*.ts を使ってください。否定では順序が重要です。! パターンは、先に書かれたパターンがマッチしたパスだけを除外します。glob のマッチングは既定で大文字小文字を区別し、ツール(minimatch、micromatch、シェルのグロブ、.gitignore)ごとに微妙な違いがあるため、実際にデプロイで使うツールで結果を確認してください。