比對模式

主機權限內容指令碼比對是以比對所定義的一組網址為依據 例如模式比對模式基本上是開頭為允許的配置 (httphttpsfileftp,且可以包含「*」字元。與特殊模式 <all_urls> 比對的 任何以允許配置為開頭的網址。每個比對模式都包含 3 個部分:

  • 配置:例如 httpfile*

    注意:系統不會自動存取 file 網址。使用者必須造訪擴充功能管理頁面,並為提出要求的所有擴充功能選擇啟用 file 存取權。
  • 主機:例如 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;

*」的意義取決於「配置」、「主機」或「路徑」部分。如果 配置*,則符合 httphttps而非 fileftpurn。如果 host 只有 *,則與任何主機相符。如果 host*._hostname_,則符合 指定的主機或其子網域在「path」區段中,每個「*」符合 0 或更多 字元。下表列出一些有效的模式。

模式用途相符網址範例
http://*/*符合任何使用 http 配置的網址http://www.google.com/
http://example.org/foo/bar.html
http://*/foo*比對任何主機上使用 http 通訊協定的所有網址,路徑開頭須為 /foohttp://example.com/foo/bar.html
http://www.google.com/foo
https://*.google.com/foo*bar比對任何使用 https 配置的網址,都位於 google.com 主機 (例如 www.google.com、docs.google.com 或 google.com),路徑開頭須為 /foo 並以 bar 結尾https://www.google.com/foo/baz/bar
https://docs.google.com/foobar
http://example.org/foo/bar.html符合指定網址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 的任何網址http://127.0.0.1/
http://127.0.0.1/foo/bar.html
*://mail.google.com/*比對以 http://mail.google.comhttps://mail.google.com 開頭的任何網址。http://mail.google.com/foo/baz/bar
https://mail.google.com/foobar
urn:*比對任何以 urn: 開頭的網址。urn:uuid:54723bea-c94e-480e-80c8-a69846c3f582
urn:uuid:cfa40aff-07df-45b2-9f95-e023bcf4a6da
<all_urls>比對任何使用允許配置的網址。(如需許可配置的清單,請參閱本節開頭的內容)。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缺少 scheme 分隔符 (「/」應為「//」)
foo://*配置無效

某些配置僅適用於部分結構定義。