declarativeNetRequest.testMatchOutcome()

Syntax

let result = await browser.declarativeNetRequest.testMatchOutcome(
    request,                // object
    options                 // optional object
);

Parameter

request

Die Einzelheiten der zu testenden Anfrage.

initiator Optional

Ein string. Die Initiator-URL (falls vorhanden) der hypothetischen Anfrage.

method Optional

Ein string. Die standardmäßige HTTP-Methode (in Kleinbuchstaben) der hypothetischen Anfrage. Für HTTP-Anfragen ist der Standardwert "get"; bei Nicht-HTTP-Anfragen wird dieser Wert ignoriert.

tabId Optional

Eine number. Die ID des Tabs, in dem die hypothetische Anfrage stattfindet. Sie muss keiner tatsächlichen Tab-ID entsprechen. Der Standardwert ist -1, was bedeutet, dass die Anfrage keinem Tab zugeordnet ist.

type

declarativeNetRequest.ResourceType. Der Ressourcentyp der hypothetischen Anfrage.

url

Ein string. Die URL der hypothetischen Anfrage.

options Optional

Einzelheiten zu den Optionen für die Anfrage.

includeOtherExtensions Optional

Ein boolean. Gibt an, ob zutreffende Regeln anderer Erweiterungen in matchedRules enthalten sind. Wenn Regeln anderer Erweiterungen zutreffen, hat das entsprechende matchedRule-Objekt eine extensionId-Eigenschaft. Der Standardwert ist false.

Rückgabewert

Ein Promise, das mit einem Objekt mit den folgenden Eigenschaften erfüllt wird:

matchedRules

declarativeNetRequest.MatchedRule. Einzelheiten zu den Regeln (falls vorhanden), die auf die hypothetische Anfrage zutreffen.

Wenn keine Regeln zutreffen, ist das Array matchedRules leer. Wenn die Anfrage fehlschlägt, wird das Promise mit einer Fehlermeldung zurückgewiesen.

Beispiele

Browser-Kompatibilität