declarativeNetRequest.testMatchOutcome

Prüft, ob eine der declarativeNetRequest-Regeln der Erweiterung mit einer hypothetischen Anfrage übereinstimmen würde. Diese Funktion ist nur während der Testphase verfügbar, da sie für die Entwicklung von Erweiterungen gedacht ist. Siehe Testen für Details dazu, wie Tests in jedem Browser aktiviert werden.

Syntax

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

Parameter

request

Die Details der zu testenden Anfrage.

initiator Optional: Ein string. Die initiatorische URL (falls vorhanden) für die hypothetische Anfrage.
method Optional: Ein string. Die standardmäßige (kleingeschriebene) HTTP-Methode der hypothetischen Anfrage. Voreinstellung 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 verbunden ist.
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 enthalten sind. Wenn Regeln von anderen Erweiterungen übereinstimmen, enthält die resultierende matchedRule eine extensionId-Eigenschaft. Standard ist false.

Rückgabewert

Ein Promise, das ein Objekt mit diesen Eigenschaften liefert:

matchedRules: declarativeNetRequest.MatchedRule. Details der Regeln (falls vorhanden), die mit der hypothetischen Anfrage übereinstimmen.

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

Beispiele

Browser-Kompatibilität

BCD tables only load in the browser