匹配模式(Match patterns
)
一伦意、匹配模式結(jié)構(gòu)
匹配模式是采用以下結(jié)構(gòu)的網(wǎng)址,用于指定一組網(wǎng)址:
<scheme>://<host>/<path>
1. scheme
必須是以下內(nèi)容之一硼补,并使用雙斜線(xiàn) (//
) 與格式的其余部分分隔開(kāi):
http
https
- 通配符
*
驮肉,僅與http
或https
匹配 file
2. host
主機(jī)名 (www.example.com
)。
- 主機(jī)名前的
*
(用于匹配子網(wǎng)域 (*.example.com
))已骇,或僅使用通配符*
离钝。 - 如果在主機(jī)模式中使用通配符,它必須是第一個(gè)或唯一字符褪储,并且后面必須跟一個(gè)句點(diǎn) (
.
) 或正斜杠 (/
)卵渴。
3. path
網(wǎng)址路徑 (/example
)。
- 對(duì)于主機(jī)權(quán)限鲤竹,必須提供路徑浪读,但該路徑會(huì)被忽略。按照慣例辛藻,應(yīng)使用通配符 (
/*
)碘橘。
二、特殊匹配
1. "<all_urls>"
- 匹配以允許方案開(kāi)頭的所有網(wǎng)址吱肌,包括有效格式下列出的任何格式痘拆。由于會(huì)影響所有主機(jī),因此在 Chrome 應(yīng)用商店中審核使用它的擴(kuò)展程序可能需要更長(zhǎng)時(shí)間氮墨。
2. "file:///"
- 允許擴(kuò)展程序在本地文件上運(yùn)行纺蛆。此模式要求用戶(hù)手動(dòng)授予訪(fǎng)問(wèn)權(quán)限。請(qǐng)注意规揪,該情況需要三個(gè)斜杠桥氏,而不是兩個(gè)。
3. 本地主機(jī)網(wǎng)址和 IP
地址
- 如需在開(kāi)發(fā)期間匹配任何
localhost
端口猛铅,請(qǐng)使用http://localhost/*
字支。對(duì)于IP
地址,請(qǐng)?jiān)诼窂街兄付ǖ刂凡⑻砑油ㄅ浞?http://127.0.0.1/*
祥款。還可以使用http://*:*/*
來(lái)匹配localhost、IP
地址和任何端口月杉。
4. 頂級(jí)網(wǎng)域匹配模式(Top Level domain
)
-
Chrome
不支持頂級(jí)域名 (TLD
) 的匹配格式刃跛。在各個(gè)TLD
中指定匹配模式,例如http://google.es/*
和http://google.fr/*
苛萎。
三桨昙、使用場(chǎng)景
擴(kuò)展程序可在多種使用場(chǎng)景中使用匹配模式,包括:
- 注入內(nèi)容腳本腌歉。
-
聲明某些
Chrome API
除自身權(quán)限外還需要一些主機(jī)權(quán)限蛙酪。 - 授予對(duì)可通過(guò)
Web
訪(fǎng)問(wèn)的資源的訪(fǎng)問(wèn)權(quán)限。 - 允許使用
"externally_connectable.matches"
清單鍵收發(fā)消息翘盖。
四桂塞、示例
-
https://*/*
或https://*/
- 匹配使用
https
架構(gòu)的所有網(wǎng)址。
- 匹配使用
-
https://*/foo*
- 匹配任意主機(jī)上使用
https
架構(gòu)且路徑以foo
開(kāi)頭的任何網(wǎng)址馍驯。匹配示例包括https://example.com/foo/bar.html
和https://www.google.com/foo
阁危。
- 匹配任意主機(jī)上使用
-
https://*.google.com/foo*bar
- 匹配
google.com
主機(jī)上使用https
架構(gòu)且路徑以foo
開(kāi)頭、以bar
結(jié)尾的任何網(wǎng)址汰瘫。匹配示例包括https://www.google.com/foo/baz/bar
和https://docs.google.com/foobar
策州。
- 匹配
-
file:///foo*
- 匹配路徑以
foo
開(kāi)頭的所有本地文件目溉。匹配示例包括file:///foo/bar.html
和file:///foo
。
- 匹配路徑以
-
http://127.0.0.1/*
或http://127.0.0.1/
- 匹配主機(jī) 127.0.0.1 上使用
http
架構(gòu)的所有網(wǎng)址。匹配示例包括http://127.0.0.1/
和http://127.0.0.1/foo/bar.html
尘奏。
- 匹配主機(jī) 127.0.0.1 上使用
-
http://localhost/*
- 匹配任何
localhost
端口。
- 匹配任何
-
*://mail.google.com/
或*://mail.google.com/*
- 匹配以
http://mail.google.com
或https://mail.google.com
開(kāi)頭的所有網(wǎng)址额港。
- 匹配以