declarativeNetRequest.testMatchOutcome
檢查擴充套件程式的 declarativeNetRequest 規則是否會匹配一個假設的請求。僅在測試時可用,因為此功能旨在用於擴充套件開發。有關如何在每個瀏覽器中啟用測試的詳細資訊,請參閱 Testing。
語法
js
let result = await browser.declarativeNetRequest.testMatchOutcome(
request, // object
options // optional object
);
引數
請求-
要測試的請求的詳細資訊。
initiator可選-
一個
string。假設請求的啟動器 URL(如果存在)。 method可選-
一個
string。假設請求的標準(小寫)HTTP 方法。HTTP 請求預設為"get",對於非 HTTP 請求則忽略。 tabId可選-
一個
number。假設請求發生的標籤的 ID。無需對應真實的標籤 ID。預設值為-1,表示請求與標籤無關。 type-
declarativeNetRequest.ResourceType。假設請求的資源型別。 url-
一個
string。假設請求的 URL。
options可選-
請求選項的詳細資訊。
includeOtherExtensions可選-
一個
boolean。是否將其他擴充套件程式的規則包含在matchedRules中。當其他擴充套件程式的規則匹配時,生成的matchedRule會有一個extensionId屬性。預設為false。
返回值
一個 Promise,它將以具有這些屬性的物件解析
matchedRules-
declarativeNetRequest.MatchedRule。匹配假設請求的規則(如果存在)的詳細資訊。
如果沒有規則匹配,則 matchedRules 陣列為空。如果請求失敗,則 Promise 會以錯誤訊息被拒絕。
示例
瀏覽器相容性
載入中…