ホストの権限とコンテンツ スクリプトの照合は、一致によって定義された一連の URL に基づきます
パターンです。一致パターンとは基本的に、許可されたスキーム(http
、https
、
file
または ftp
。「*
」を含むことができますあります。特殊なパターン <all_urls>
は、次と一致します。
許可されたスキームで始まる URL各一致パターンは次の 3 つの部分で構成されます。
scheme -
http
、file
、*
など注:file
URL へのアクセスは自動的には行われません。ユーザーは拡張機能の管理ページにアクセスし、リクエストする拡張機能ごとにfile
へのアクセスを有効にする必要があります。host(例:
www.google.com
、*.google.com
、*
)。スキームがfile
の場合、 host 部分がないpath -
/*
、/foo*
、/foo/bar
など。パスはホスト権限に存在する必要があります。 ただし、常に/*
として扱われます。
基本的な構文は次のとおりです。
<url-pattern> := <scheme>://<host><path>
<scheme> := '*' | 'http' | 'https' | 'file' | 'ftp' | 'urn'
<host> := '*' | '*.' <any char except '/' and '*'>+
<path> := '/' <any chars>
「*
」の意味これは、scheme、host、path のどの部分に含まれるかによって異なります。もし
scheme が *
の場合、http
または https
に一致します。file
、ftp
、urn
には一致しません。もし
host は単に *
であり、任意のホストに一致します。host が *._hostname_
の場合は、次と一致します。
特定のホストやそのサブドメインに対しても適用されます。path セクションの各「*
」0 以上に一致
あります。次の表に、有効なパターンを示します。
パターン | 機能 | 一致する URL の例 |
---|---|---|
http://*/* | http スキームを使用するすべての URL が一致します | http://www.google.com/ http://example.org/foo/bar.html |
http://*/foo* | パスが /foo で始まる任意のホストで、http スキームを使用するすべての URL と一致します。 | http://example.com/foo/bar.html http://www.google.com/foo |
https://*.google.com/foo*bar | パスが /foo で始まり bar で終わる、google.com ホスト上の、https スキームを使用するすべての URL(www.google.com、docs.google.com、google.com など)が一致します。 | https://www.google.com/foo/baz/bar https://docs.google.com/foobar |
http://example.org/foo/bar.html | 指定した URL と一致します | http://example.org/foo/bar.html |
file:///foo* | パスが /foo で始まるすべてのローカル ファイルと一致します。 | file:///foo/bar.html file:///foo |
http://127.0.0.1/* | http スキームを使用し、ホスト 127.0.0.1 にあるすべての URL と一致します。 | http://127.0.0.1/ http://127.0.0.1/foo/bar.html |
*://mail.google.com/* | http://mail.google.com または https://mail.google.com で始まるすべての URL が一致します。 | http://mail.google.com/foo/baz/bar https://mail.google.com/foobar |
urn:* | urn: で始まるすべての URL が一致します。 | urn:uuid:54723bea-c94e-480e-80c8-a69846c3f582 urn:uuid:cfa40aff-07df-45b2-9f95-e023bcf4a6da |
<all_urls> | 許可されたスキームを使用するすべての URL が一致します。(許可されるスキームのリストについては、このセクションの冒頭をご覧ください)。 | http://example.org/foo/bar.html file:///bar/baz.html |
無効なパターン一致の例を次に示します。
不適切なパターン | 「悪い」と評価した理由 |
---|---|
http://www.google.com | パスがありません |
http://*foo/bar | 「*」host の後には「.」のみを付けることができるまたは「/」 |
http://foo.*.bar/baz | 「*」の場合host にある場合、最初の文字である必要がある |
http:/bar | スキームの区切り文字がありません(「/」は「//」にしてください) |
foo://* | 無効なスキーム |
一部のスキームは、状況によってはサポートされない場合があります。