declarativeNetRequest.testMatchOutcome

Überprüft, ob eine der declarativeNetRequest-Regeln der Erweiterung eine hypothetische Anforderung erfüllen würde. Diese Funktion ist nur während des Testens verfügbar, da sie während der Entwicklung von Erweiterungen verwendet werden soll. Sehen Sie unter Testing nach, wie das Testen in jedem Browser aktiviert wird.

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 Initiator-URL (falls vorhanden) für die hypothetische Anfrage.
method Optional: Ein string. Die standardmäßige (klein geschriebene) 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 erfolgt. Die ID muss nicht mit einer realen Tab-ID übereinstimmen. Die Standardeinstellung ist -1, was bedeutet, dass die Anfrage nicht mit einem Tab in Verbindung steht.
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 Übereinstimmungen von Regeln anderer Erweiterungen in matchedRules eingeschlossen werden. Wenn Regeln von anderen Erweiterungen übereinstimmen, besitzt die resultierende matchedRule eine extensionId-Eigenschaft. Standardmäßig ist false.

Rückgabewert

Ein Promise, das mit einem Objekt erfüllt wird, das diese Eigenschaften hat:

matchedRules: declarativeNetRequest.MatchedRule. Details der Regeln (falls vorhanden), die zur hypothetischen Anfrage passen.

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

Beispiele

Browser-Kompatibilität

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden