一致パターン

一致パターンは、URL のグループを指定するために使用される、次の構造の URL です。

<scheme>://<host>:<port>/<path>

scheme: 次のいずれかである必要があります。パターン内の他の部分とは、コロンとダブルスラッシュ（://）で区切ります。

  • http
  • https
  • ワイルドカード *。http または https のみに一致します。
  • file

about: や data: などのサポートされていないスキームにコンテンツ スクリプトを挿入する方法については、関連フレームへの挿入をご覧ください。

host: ホスト名（www.example.com）。サブドメイン（*.example.com）を照合するホスト名の前の *、またはワイルドカード * のみ。- ホスト パターンでワイルドカードを使用する場合は、最初の文字または唯一の文字である必要があり、ピリオド（.）またはスラッシュ（/）が後に続く必要があります。

port（省略可）: 照合するポート。デフォルトでは、これは :* と同じ動作のワイルドカードとして扱われます。

path: URL パス（/example）。ホスト権限の場合、パスは必須ですが無視されます。慣例により、ワイルドカード（/*）を使用する必要があります。

拡張機能では、次のようなさまざまなユースケースで一致パターンが使用されます。

特殊なケース

"<all_urls>"
許可されたスキームで始まる URL に一致します。これには、有効なパターンに記載されているパターンも含まれます。すべてのホストに影響するため、この API を使用する拡張機能の Chrome ウェブストアのレビューには時間がかかる場合があります。
"file:///"
拡張機能がローカル ファイルで実行されるようにします。このパターンでは、ユーザーが手動でアクセスを許可する必要があります。この場合は、2 つではなく 3 つのスラッシュが必要です。
ローカルホストの URL と IP アドレス
http://localhost/* または http://127.0.0.1/*（IP アドレスを照合する場合）を使用します。明示的なポートが指定されていない限り、一致パターンはすべてのポートに一致します。
トップレベル ドメインの一致パターン
Chrome では、トップレベル ドメイン（TLD）のマッチパターンはサポートされていません。http://google.es/* や http://google.fr/* のように、個々の TLD 内で一致パターンを指定します。

パターンの例

https://*/* または https://*/
https スキームを使用する URL に一致します。
https://*/foo*
https スキームを使用するすべての URL に一致します。ホストは任意で、パスは foo で始まります。一致する例としては、https://example.com/foo/bar.html や https://www.google.com/foo などがあります。
https://*.google.com/foo*bar
https スキームを使用し、google.com ホスト上で、パスが foo で始まり bar で終わる URL に一致します。一致する例としては、https://www.google.com/foo/baz/bar や https://docs.google.com/foobar などがあります。
file:///foo*
パスが foo で始まるローカル ファイルに一致します。一致する例としては、file:///foo/bar.html や file:///foo などがあります。
http://127.0.0.1/* または http://127.0.0.1/
http スキームを使用し、ホスト 127.0.0.1 にあるすべての URL に一致します。一致する例としては、http://127.0.0.1/ や http://127.0.0.1/foo/bar.html などがあります。
http://localhost/*
任意の localhost ポートに一致します。
*://mail.google.com/ または *://mail.google.com/*
http://mail.google.com または https://mail.google.com で始まる URL に一致します。