declarativeNetRequest.testMatchOutcome

Prüft, ob eine der declarativeNetRequest-Regeln der Erweiterung eine hypothetische Anfrage entsprechen würde. Nur während des Testens verfügbar, da dies während der Entwicklung von Erweiterungen verwendet werden soll. Siehe Testing für Details, wie Tests in jedem Browser aktiviert werden.

Syntax

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

Parameter

request

Die Details der zu testenden Anfrage.

initiator Optional

Ein string. Die Initiator-URL (falls vorhanden) für die hypothetische Anfrage.

method Optional

Ein string. Die standardmäßige (klein geschriebene) HTTP-Methode der hypothetischen Anfrage. Standard ist "get" für HTTP-Anfragen und wird für Nicht-HTTP-Anfragen ignoriert.

tabId Optional

Eine number. Die ID des Tabs, in dem die hypothetische Anfrage stattfindet. Muss nicht mit einer realen Tab-ID übereinstimmen. Standard ist -1, was bedeutet, dass die Anfrage nicht mit einem Tab zusammenhängt.

type

declarativeNetRequest.ResourceType. Der Ressourcentyp der hypothetischen Anfrage.

url

Ein string. Die URL der hypothetischen Anfrage.

options Optional

Details der Optionen für die Anfrage.

includeOtherExtensions Optional

Ein boolean. Ob übereinstimmende Regeln von anderen Erweiterungen in matchedRules eingeschlossen werden. Wenn Regeln von anderen Erweiterungen übereinstimmen, hat die resultierende matchedRule-Eigenschaft eine extensionId. Standard ist false.

Rückgabewert

Ein Promise, das mit einem Objekt erfüllt wird, das folgende Eigenschaften enthält:

matchedRules

declarativeNetRequest.MatchedRule. Details der Regeln (falls vorhanden), die der hypothetischen Anfrage entsprechen.

Wenn keine Regeln übereinstimmen, ist das matchedRules-Array leer. Wenn die Anfrage fehlschlägt, wird das Versprechen mit einer Fehlermeldung abgelehnt.

Beispiele

Browser-Kompatibilität