共用方式為


定義檔案網址擴充功能的匹配模式

Microsoft Edge 擴充功能可以請求存取 file URL。 要啟用此功能,你需要明確設定此存取權限。 存取 file 網址並非自動發生。 您必須造訪 Microsoft Edge 擴充套件管理頁面,才能選擇存取file每個請求存取 file URL 的 Microsoft Edge 擴充功能。

對於 Microsoft Edge 擴充套件,主機權限與內容腳本模式匹配的運作方式如下。

主機權限與內容腳本匹配基於一組由匹配模式定義的 URL。 匹配模式本質上是一個以允許的方案開頭的網址,httpsfile (http、或ftp,且可包含「*」字元。 特殊模式 <all_urls> 會匹配任何以允許方案開頭的網址。 每個比賽模式包含三個部分:

  • scheme — 例如,httpfile*

  • _host_— 例如,www.google.com*.google.com*或;若方案為檔案,則不存在宿主部分。

  • _path_ — 例如, /*、、 /foo*/foo/bar。 路徑必須存在於主機權限中,但總是被視為 /*

基本語法

基本語法如下:

<url-pattern> := <scheme>://<host><path>
<scheme> := '*' | 'http' | 'https' | 'file' | 'ftp'
<host> := '*' | '*.' <any char except '/' and '*'>+
<path> := '/' <any chars>

* 意義取決於它屬於 scheme、host 或 path 部分。 若該概型為 *,則它與 或 之一相匹配httphttps,而非 file,或 ftp。 若宿主僅 *為 ,則與任意宿主相匹配。 若主機為 *.hostname,則與指定的主機或任一子網域相匹配。 在路徑區塊中,每個 * 角色匹配的字元數量為 0 或更多。 下表展示了一些有效的模式。

有效模式範例

模式 功能 匹配網址的範例
http://*/* 匹配任何使用 http 方案的 URL http://www.google.com http://example.org/foo/bar.html
http://*/foo* 只要路徑以 為起點,就能匹配任何使用 http 方案的 URL /foo http://example.com/foo/bar.html http://www.google.com/foo
https://*.google.com/foo*bar 只要路徑起始且結束於 ,只要路徑以 為 ,且結束於 ,則符合任何使用 https 方案google.com的 URL 與 ,且在主機 (google.comwww.google.comdocs.google.com、 或) 上 匹配/foobar https://www.google.com/foo/baz/bar https://docs.google.com/foobar
http://example.org/foo/bar.html 與指定的網址相符 http://example.org/foo/bar.html
file:///foo* 匹配任何路徑以 /foo file:///foo/bar.html file:///foo
http://127.0.0.1/* 匹配任何使用該 http 方案且在主機上的 URL 127.0.0.1 http://127.0.0.1 http://127.0.0.1/foo/bar.html
*://mail.google.com/* 匹配任何以 http://mail.google.comhttps://mail.google.com開頭的 URL 。 http://mail.google.com/foo/baz/bar https://mail.google.com/foobar
<all_urls> 匹配任何使用允許方案的網址。 (請參閱本節開頭的允許方案清單 ) http://example.org/foo/bar.html file:///bar/baz.html

無效模式範例

以下是一些圖案匹配的範例 _invalid_

糟糕的模式 為什麼它不好
http://www.foo.com _path_
http://*foo/bar 在 host 中,「*'' 後面只能接著 '.' 或/
http://foo.*.bar/baz 若 '*' 位於 _host_,則必須是第一個字元
http:/bar 缺少 _scheme_ 分隔符 (」應該/是「//」)
foo://* 無效的 _scheme_

有些方案並非在所有情境下都被支援。

注意事項

本頁部分內容基於 Google 創作與 分享 的作品,並依 據創用CC 姓名標示 4.0 國際授權條款進行修改。 原始頁面 可在此查閱。

創用CC授權 本作品採用 創用CC 姓名標示4.0國際授權條款授權。