比對模式

比對模式是一個採用下列結構的網址,用於指定一組網址:

<scheme>://<host>/<path>

scheme:必須是下列其中一種格式,並以雙斜線 (//) 與模式的其餘部分分開:

  • http
  • https
  • 萬用字元 *,僅比對 httphttps
  • file

如要瞭解如何將內容指令碼插入不支援的配置 (例如 about:data:),請參閱「在相關頁框中插入內容」。

host:主機名稱 (www.example.com)。主機名稱前的 * 用於比對子網域 (*.example.com),或只是萬用字元 *。- 如要在主機模式中使用萬用字元,該字元必須是第一個或唯一的字元,且後方必須加上半形句號 (.) 或正斜線 (/)。

path:網址路徑 (/example)。如果是主機權限,路徑為必要項目,但系統會忽略。請依慣例使用萬用字元 (/*)。

擴充功能會在各種用途中使用比對模式,包括:

特殊情況

"<all_urls>"
比對任何以允許配置開頭的網址,包括有效模式中列出的任何模式。由於 Chrome 線上應用程式商店會影響所有主機,因此使用 Chrome 線上應用程式商店的擴充功能就可能需時更久
"file:///"
允許擴充功能在本機檔案上執行。這個模式需要使用者手動授予存取權。請注意,本例需要三條斜線,而非兩個斜線。
本機主機網址和 IP 位址
如要在開發期間比對任何 localhost 通訊埠,請使用 http://localhost/*。至於 IP 位址,請將該位址加上路徑中的萬用字元,如 http://127.0.0.1/* 所示。您也可以使用 http://*:*/* 來比對 localhost、IP 位址和任何通訊埠。
頂層網域比對模式
Chrome 不支援頂層網域 (TLD) 的比對模式。請在個別 TLD 中指定比對模式,例如 http://google.es/*http://google.fr/*

範例模式

https://*/*https://*/
比對使用 https 配置的任何網址。
https://*/foo*
比對任何主機上使用 https 配置的任何網址,路徑開頭為 foo。相符項目的範例包括 https://example.com/foo/bar.htmlhttps://www.google.com/foo
https://*.google.com/foo*bar
比對 google.com 主機上使用 https 配置的任何網址,路徑開頭為 foo,結尾是 bar。相符項目的範例包括 https://www.google.com/foo/baz/barhttps://docs.google.com/foobar
file:///foo*
比對路徑開頭為 foo 的任何本機檔案。相符項目的範例包括 file:///foo/bar.htmlfile:///foo
http://127.0.0.1/*http://127.0.0.1/
比對使用 http 配置且位於主機 127.0.0.1 的所有網址。相符項目的範例包括 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.comhttps://mail.google.com 的任何網址。