declarativeNetRequest.getMatchedRules

返回擴充套件匹配到的所有規則。呼叫者可以透過指定 filter 來過濾匹配到的規則列表。此方法僅對擁有 "declarativeNetRequestFeedback" 許可權的擴充套件可用,或者對 filter 中指定的 tabId 擁有 "activeTab" 許可權的擴充套件可用。不與活動文件相關聯且在五分鐘前匹配到的規則不會被返回。

語法

js
let gettingMatchedRules = await browser.declarativeNetRequest.getMatchedRules(
    filter                // object
);

引數

filter 可選

用於過濾匹配規則列表的物件。

minTimeStamp 可選

一個 number。如果指定,則僅匹配指定時間戳之後的規則。

tabId 可選

一個 number。如果指定,則僅匹配指定標籤頁的規則。如果設定為 -1,則匹配不與任何活動標籤頁關聯的規則。

返回值

一個 Promise,它將以具有這些屬性的物件解析

rule

declarativeNetRequest.MatchedRule。匹配規則的詳細資訊。

tabId

number 請求來源的標籤頁的 tabId,如果該標籤頁仍然處於活動狀態。否則為 -1

timeStamp

number 規則匹配的時間。時間戳對應 JavaScript 的時間約定,即自紀元以來的毫秒數。

如果沒有匹配到規則,則返回空物件。如果請求失敗,Promise 將以錯誤訊息被拒絕。

示例

瀏覽器相容性