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 會以錯誤訊息被拒絕。

示例

瀏覽器相容性