多個原則需要 URL 模式來指定它們套用的 URL。 下列規則說明這些型樣的規格。
有效的型樣規格
有效的型樣規格是下列其中一種形式 (,不含引號) :
"*"
- 此模式符合任何 URL、具有任何配置、埠和路徑。
“scheme://domains:端口/路徑”
- 支援的配置是 “http” 和 “https”。
- 可以省略該配置,以及配置分隔符“://”以匹配任何配置。 或者,可以使用萬用字元 “*” 來達到相同的效果。
- 網域後面接著最上層網域,前置詞為一或多個子網域。 或者,也可以改用主機 (,例如 localhost) 。
- 網域以萬用字元「[*.]」為前綴,以符合網域或其任何子網域。 有問題的網域可以是任何層級的子網域。 萬用字元 “[*.]” 後面沒有點,應該直接以字首加到域/子域。
- 沒有萬用字元前置詞的網域只會符合該確切網域,而不符合任何子網域。
- 埠是0-65535範圍內的數字。 它可以與埠分隔符「:」一起省略,或替換為萬用字元「*」以匹配任何埠。
- 同樣地,路徑可以與零件分隔符號 “/” 一起省略,或以萬用字元 “*” 取代以符合任何路徑。
- 萬用字元無法用於部分比對配置、網域、主機、埠或路徑。
- 支援在相同模式中使用多個萬用字元 (例如 ://google.com:/*) 。
“scheme://a.b.c.d:端口/路徑”
- 可以使用「a.b.c.d」形式的 IPv4 位址來取代網域。 雖然配置、連接埠和路徑的規則與網域 URL 相同,但 IP 位址根本無法使用萬用字元。
“scheme://[a:b:c:d:e:f:g:h]:p ort/路徑”
- IPv6 位址也可以以「[a:b:c:d:e:f:g:h]」的形式使用。 括號是強制性的。 就像 IPv4 位址一樣,不支援萬用字元。 配置、連接埠和路徑的規則與網域 URL 和 IPv4 位址的規則相同。
“file://path”
- 如果使用「檔案」方案,則路徑必須以「/」開頭,因此「file://dir/myfile.html」是無效的模式。 需要改用“file:”後面帶有三個正斜線的“file:///dir/myfile.html” () 。 唯一有效的檔案 URL 萬用字元格式是 “file:///*”,它符合任何有效的檔案 URL。
- 檔案 URL 的網域部分必須是空的,且符合任何網域 (或 localhost) 。 例如,“file:///file.html” 匹配 “file://localhost/file.html” 和 “file://mysite.com/file.html”。
- 無法使用連接埠。
無效的模式
下列模式無效。
- [*.].mysite.com 無效 (注意到「mysite」之前的點 ) 。
- file://mysite.com/somefile.html 無效,因為網域是非空白的 (不允許在檔案 URL) 中。
- file://somefile.html 無效 (只有兩個正斜線而不是三個) 。
- file://somefile。 (唯一包含萬用字元的有效檔案 URL 是 file:///) 。
- [*.]127.0.0.1 無效 (使用具有 IP 位址的子網域或子網域萬用字元) 無效。
模式範例
模式的一些範例包括:
- [*.]mysite.com 匹配 mysite.com 和 subdomain.mysite.com。 它也會符合任何配置、連接埠和路徑。
- [*.]ontoso.com 與 contoso.com 不符。 然而,它確實符合 subdomain.ontoso.com。
- file:///foo/bar.html 匹配 file://localhost/foo/bar.html 和 file://mysite.com/foo/bar.html。
- file:///* 有效且符合任何 file:// URL。
- 配置、連接埠和路徑可以與 IP 位址一起使用,例如 https://[::1]:8080/myfile.html 有效。
內容授權
注意
本頁的某些部分是根據 Chromium.org 創造和分享的作品加以修改,並根據創用 CC 姓名標示 4.0 國際版本授權條款中所述條款加以使用。 原始 Chromium 頁面可在此處找到。
本作品根據創用 CC 姓名標示 4.0 國際版本授權條款獲得授權。