一致パターンは、次の構造を持つ URL で、URL のグループを指定します。
<scheme>://<host>/<path>
scheme: 次のいずれかを、ダブル スラッシュ(//
)を使用してパターンの残りの部分から区切る必要があります。
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
- google.com ホストで、
https
スキームを使用して、パスが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 と一致します。