比對模式是一個採用下列結構的網址,用於指定一組網址:
<scheme>://<host>/<path>
scheme:必須是下列其中一種格式,並以雙斜線 (//
) 與模式的其餘部分分開:
http
https
- 萬用字元
*
,僅比對http
或https
file
如要瞭解如何將內容指令碼插入不支援的配置 (例如 about:
和 data:
),請參閱「在相關頁框中插入內容」。
host:主機名稱 (www.example.com
)。主機名稱前的 *
用於比對子網域 (*.example.com
),或只是萬用字元 *
。- 如要在主機模式中使用萬用字元,該字元必須是第一個或唯一的字元,且後方必須加上半形句號 (.
) 或正斜線 (/
)。
path:網址路徑 (/example
)。如果是主機權限,路徑為必要項目,但系統會忽略。請依慣例使用萬用字元 (/*
)。
擴充功能會在各種用途中使用比對模式,包括:
- 插入內容指令碼。
- 宣告除了自有權限之外,部分 Chrome API 所需的主機權限。
- 授予可存取網路的資源。
- 允許使用 "externally_connectable.matches" 資訊清單金鑰來收發訊息。
特殊情況
"<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.html
和https://www.google.com/foo
。 https://*.google.com/foo*bar
- 比對 google.com 主機上使用
https
配置的任何網址,路徑開頭為foo
,結尾是bar
。相符項目的範例包括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 的所有網址。相符項目的範例包括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
的任何網址。