一致パターンは、URL のグループを指定するのに使用される次の構造の URL です。
<scheme>://<host>/<path>
スキーム: 次のいずれかであり、パターンの残りの部分とは二重スラッシュ(//
)で区切る必要があります。
http
https
- ワイルドカード
*
(http
またはhttps
のみに一致) file
サポートされていないスキーム(about:
や data:
など)にコンテンツ スクリプトを挿入する方法については、関連フレームへの挿入をご覧ください。
host: ホスト名(www.example.com
)。サブドメイン(*.example.com
)を照合するためにホスト名の前に *
を付けるか、ワイルドカード *
を使用します。- ホストパターンでワイルドカードを使用する場合は、ワイルドカードが最初の文字または唯一の文字で、その後にピリオド(.
)またはスラッシュ(/
)が続くようにする必要があります。
path: URL パス(/example
)。ホスト権限の場合、パスは必須ですが無視されます。ワイルドカード(/*
)は規則に従って使用する必要があります。
拡張機能では、次のようなさまざまなユースケースで一致パターンを使用します。
- コンテンツ スクリプトの挿入。
- 一部の Chrome API で、独自の権限に加えて必要なホスト権限の宣言。
- ウェブでアクセス可能なリソースへのアクセス権の付与。
- "externally_connectable.matches" マニフェスト キーを使用してメッセージの送受信を許可する。
特殊なケース
"<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.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 に一致します。