匹配模式（Match patterns）

一、匹配模式結(jié)構(gòu)

匹配模式是采用以下結(jié)構(gòu)的網(wǎng)址，用于指定一組網(wǎng)址：

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

1. scheme

必須是以下內(nèi)容之一，并使用雙斜線 (//) 與格式的其余部分分隔開：

• http
• https
• 通配符 *，僅與 http 或 https 匹配
• file

2. host

主機(jī)名 (www.example.com)。

• 主機(jī)名前的 *（用于匹配子網(wǎng)域 (*.example.com)），或僅使用通配符 *。
• 如果在主機(jī)模式中使用通配符，它必須是第一個或唯一字符，并且后面必須跟一個句點 (.) 或正斜杠 (/)。

3. path

網(wǎng)址路徑 (/example)。

• 對于主機(jī)權(quán)限，必須提供路徑，但該路徑會被忽略。按照慣例，應(yīng)使用通配符 (/*)。

二、特殊匹配

1. "<all_urls>"

• 匹配以允許方案開頭的所有網(wǎng)址，包括有效格式下列出的任何格式。由于會影響所有主機(jī)，因此在 Chrome 應(yīng)用商店中審核使用它的擴(kuò)展程序可能需要更長時間。

2. "file:///"

• 允許擴(kuò)展程序在本地文件上運(yùn)行。此模式要求用戶手動授予訪問權(quán)限。請注意，該情況需要三個斜杠，而不是兩個。

3. 本地主機(jī)網(wǎng)址和 IP 地址

• 如需在開發(fā)期間匹配任何 localhost 端口，請使用 http://localhost/*。對于 IP 地址，請在路徑中指定地址并添加通配符，例如 http://127.0.0.1/*。還可以使用 http://*:*/* 來匹配 localhost、IP 地址和任何端口。

4. 頂級網(wǎng)域匹配模式（Top Level domain）

• Chrome 不支持頂級域名 (TLD) 的匹配格式。在各個 TLD 中指定匹配模式，例如 http://google.es/* 和 http://google.fr/*。

三、使用場景

擴(kuò)展程序可在多種使用場景中使用匹配模式，包括：

• 注入內(nèi)容腳本。
• 聲明某些 Chrome API 除自身權(quán)限外還需要一些主機(jī)權(quán)限。
• 授予對可通過 Web 訪問的資源的訪問權(quán)限。
• 允許使用 "externally_connectable.matches" 清單鍵收發(fā)消息。

四、示例

• https://*/* 或 https://*/
  • 匹配使用 https 架構(gòu)的所有網(wǎng)址。
• https://*/foo*
  • 匹配任意主機(jī)上使用 https 架構(gòu)且路徑以 foo 開頭的任何網(wǎng)址。匹配示例包括 https://example.com/foo/bar.html 和 https://www.google.com/foo。
• https://*.google.com/foo*bar
  • 匹配 google.com 主機(jī)上使用 https 架構(gòu)且路徑以 foo 開頭、以 bar 結(jié)尾的任何網(wǎng)址。匹配示例包括 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/
  • 匹配主機(jī) 127.0.0.1 上使用 http 架構(gòu)的所有網(wǎng)址。匹配示例包括 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 開頭的所有網(wǎng)址。

引用

• 【match-patterns】