比對模式

比對模式是具有下列結構的網址，用於指定一組網址：

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

結構定義：必須是下列其中一種，並以冒號和雙斜線 (://) 與模式的其餘部分分隔：

  • http
  • https
  • 萬用字元 *，只與 http 或 https 相符
  • file

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

主機：主機名稱 (www.example.com)。主機名稱前的 * 可比對子網域 (*.example.com)，或只是萬用字元 *。 - 如果在主機模式中使用萬用字元，則必須是第一個或唯一字元，且後面必須接半形句號 (.) 或正斜線 (/)。

通訊埠 (選用)：要比對的通訊埠。根據預設，這會視為萬用字元，行為與 :* 相同。

路徑：網址路徑 (/example)。如果是主機權限，則路徑為必填，但會遭到忽略。請按照慣例使用萬用字元 (/*)。

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

特殊情況

"<all_urls>"
：比對以允許的配置開頭的任何網址，包括「有效模式」下列出的任何模式。由於這項權限會影響所有主機，因此使用這項權限的擴充功能，可能需要較長時間才能通過 Chrome 線上應用程式商店審查。
"file:///"
允許擴充功能在本機檔案上執行。使用者必須手動授予存取權，請注意，這個情況需要三個斜線，而不是兩個。
localhost 網址和 IP 位址
使用 http://localhost/* 或 http://127.0.0.1/* (比對 IP 位址)。除非指定明確的通訊埠，否則比對模式會比對所有通訊埠。
頂層網域相符模式
Chrome 不支援頂層網域 (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 開頭的網址。