一致パターン

ホストの権限コンテンツ スクリプトの照合は、一致によって定義された一連の URL に基づきます パターンです。一致パターンとは基本的に、許可されたスキーム(httphttpsfile または ftp。「*」を含むことができますあります。特殊なパターン <all_urls> は、次と一致します。 許可されたスキームで始まる URL各一致パターンは次の 3 つの部分で構成されます。

  • scheme - httpfile* など

    注: file URL へのアクセスは自動的には行われません。ユーザーは拡張機能の管理ページにアクセスし、リクエストする拡張機能ごとに file へのアクセスを有効にする必要があります。
  • host(例: www.google.com*.google.com*)。スキームが file の場合、 host 部分がない

  • path - /*/foo*/foo/bar など。パスはホスト権限に存在する必要があります。 ただし、常に /* として扱われます。

基本的な構文は次のとおりです。

&lt;url-pattern&gt; := &lt;scheme&gt;://&lt;host&gt;&lt;path&gt;
&lt;scheme&gt; := '*' | 'http' | 'https' | 'file' | 'ftp' | 'urn'
&lt;host&gt; := '*' | '*.' &lt;any char except '/' and '*'&gt;+
&lt;path&gt; := '/' &lt;any chars&gt;

*」の意味これは、schemehostpath のどの部分に含まれるかによって異なります。もし scheme* の場合、http または https に一致します。fileftpurn には一致しません。もし 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://*無効なスキーム

一部のスキームは、状況によってはサポートされない場合があります。