declarativeNetRequest.onRuleMatchedDebug

Wird ausgelöst, wenn eine Regel mit einer Anfrage übereinstimmt. Nur für Erweiterungen mit der Berechtigung "declarativeNetRequestFeedback" verfügbar, da dies nur für Debugging-Zwecke vorgesehen ist. Siehe Testen für Details, wie das Testen in jedem Browser aktiviert wird.

Syntax

browser.declarativeNetRequest.onRuleMatchedDebug.addListener(listener)
browser.declarativeNetRequest.onRuleMatchedDebug.removeListener(listener)
browser.declarativeNetRequest.onRuleMatchedDebug.hasListener(listener)

Ereignisse haben drei Funktionen:

addListener(listener): Fügt diesem Ereignis einen Listener hinzu.
removeListener(listener): Stoppt das Lauschen auf dieses Ereignis. Das Argument listener ist der zu entfernende Listener.
hasListener(listener): Überprüft, ob listener für dieses Ereignis registriert ist. Gibt true zurück, wenn es lauscht, andernfalls false.

addListener-Syntax

Parameter

listener

Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Der Funktion werden folgende Argumente übergeben:

request

Ein Objekt, das Informationen über die Anfrage enthält, mit der die Regel übereinstimmte.

documentId Optional: Ein string. Die eindeutige Kennung für das Dokument des Frames, falls diese Anfrage für einen Frame ist.
documentLifecycle Optional: Ein string. Der Lebenszyklus des Dokuments des Frames, falls diese Anfrage für einen Frame ist. Mögliche Werte sind: "prerender", "active", "cached" oder "pending_deletion".
frameId: Eine number. Der Wert 0 zeigt an, dass die Anfrage im Haupt-Frame erfolgt. Ein positiver Wert gibt die ID eines Subframes an, in dem die Anfrage erfolgt. Wenn das Dokument eines (Sub-)Frames geladen wird (Typ ist main_frame oder sub_frame), gibt frameId die ID dieses Frames an, nicht die ID des äußeren Frames. Frame-IDs sind innerhalb eines Tabs eindeutig.
frameType Optional: Ein string. Der Typ des Frames, falls diese Anfrage für einen Frame ist. Mögliche Werte sind: "outermost_frame", "fenced_frame" oder "sub_frame".
initiator Optional: Ein string. Der Ursprung, an dem die Anfrage initiiert wurde. Dies ändert sich nicht durch Umleitungen. Der String 'null' wird verwendet, wenn dies ein opaker Ursprung ist.
method: Ein string. Eine standardmäßige HTTP-Methode.
parentDocumentId Optional: Ein string. Die eindeutige Kennung für das übergeordnete Dokument des Frames, falls diese Anfrage für einen Frame ist und ein übergeordnetes Dokument hat.
parentFrameId: Eine number. Die ID des Frames, der den Frame umschließt, der die Anfrage gesendet hat. Wird auf -1 gesetzt, wenn kein übergeordneter Frame vorhanden ist.
requestId: Ein string. Die ID der Anfrage. Anfragen-IDs sind innerhalb einer Browsersitzung eindeutig.
tabId: Eine number. Die ID des Tabs, in dem die Anfrage stattfindet. Wird auf -1 gesetzt, wenn die Anfrage nicht mit einem Tab verbunden ist.
type: ResourceType. Der Ressourcentyp der Anfrage.
url: Ein string. Die URL der Anfrage.

rule

MatchedRule. Details einer übereinstimmenden Regel.

Browser-Kompatibilität

BCD tables only load in the browser