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 inmatchedRules
enthalten sind. Wenn Regeln von anderen Erweiterungen übereinstimmen, enthält die resultierendematchedRule
eineextensionId
-Eigenschaft. Standard istfalse
.
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