一致パターンは、URL のグループを指定するのに使用される次の構造の URL です。
<scheme>://<host>/<path>
スキーム: 次のいずれかであり、コロン(:)の後にダブルスラッシュ(://)を使用して残りのパターンと区切る必要があります。
httphttps- ワイルドカード
*(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 に一致します。