一致パターンは、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
- 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 に一致します。