このページは Cloud Translation API によって翻訳されました。

一致パターン

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