一致パターン

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

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

スキーム: 次のいずれかであり、パターンの残りの部分とは二重スラッシュ(//)で区切る必要があります。

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

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

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

path: URL パス(/example)。ホスト権限の場合、パスは必須ですが無視されます。ワイルドカード(/*)は規則に従って使用する必要があります。

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

特殊なケース

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

パターンの例

https://*/* または https://*/
https スキームを使用するすべての URL に一致します。
https://*/foo*
https スキームを使用し、パスが foo で始まるすべての URL に一致します。一致の例には、https://example.com/foo/bar.htmlhttps://www.google.com/foo などがあります。
https://*.google.com/foo*bar
https スキームを使用する、google.com ホストで、パスが foo で始まり bar で終わる任意の URL が一致します。一致の例としては、https://www.google.com/foo/baz/barhttps://docs.google.com/foobar などがあります。
file:///foo*
パスが foo で始まるすべてのローカル ファイルと一致します。一致の例としては、file:///foo/bar.htmlfile:///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 に一致します。