declarativeNetRequest.onRuleMatchedDebug
Wird ausgelöst, wenn eine Regel mit einer Anfrage übereinstimmt. Nur verfügbare Erweiterungen mit der Berechtigung "declarativeNetRequestFeedback", da dies nur für Debugging-Zwecke vorgesehen ist. Siehe Testen für Details dazu, 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 einen Listener zu diesem Ereignis hinzu.
removeListener(listener)-
Hört auf, auf dieses Ereignis zu hören. Das Argument
listenerist der zu entfernende Listener. hasListener(listener)-
Prüfen, ob
listenerfür dieses Ereignis registriert ist. Gibttruezurück, wenn darauf gehört wird, andernfallsfalse.
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.
documentIdOptional-
Ein
string. Der eindeutige Bezeichner für das Dokument des Rahmens, falls diese Anfrage für einen Rahmen ist. documentLifecycleOptional-
Ein
string. Der Lebenszyklus des Dokuments des Rahmens, falls diese Anfrage für einen Rahmen ist. Mögliche Werte sind:"prerender","active","cached", oder"pending_deletion". frameId-
Eine
number. Der Wert0zeigt an, dass die Anfrage im Hauptframe erfolgt. Ein positiver Wert zeigt die ID eines Unterrahmens an, in dem die Anfrage erfolgt. Wenn das Dokument eines (Unter-)Rahmens geladen wird (Typ istmain_frameodersub_frame), zeigtframeIddie ID dieses Rahmens an, nicht die des äußeren Rahmens. Rahmen-IDs sind innerhalb eines Tabs einzigartig. frameTypeOptional-
Ein
string. Der Typ des Rahmens, falls diese Anfrage für einen Rahmen ist. Mögliche Werte sind:"outermost_frame","fenced_frame", oder"sub_frame". initiatorOptional-
Ein
string. Der Ursprung, von dem die Anfrage initiiert wurde. Dies ändert sich nicht durch Weiterleitungen. Der String 'null' wird verwendet, wenn es sich um einen opaken Ursprung handelt. method-
Ein
string. Eine standardmäßige HTTP-Methode. parentDocumentIdOptional-
Ein
string. Der eindeutige Bezeichner für das übergeordnete Dokument des Rahmens, wenn diese Anfrage für einen Rahmen ist und einen Eltern hat. parentFrameId-
Eine
number. Die ID des Rahmens, der den Rahmen umfasst, der die Anfrage gesendet hat. Auf-1gesetzt, wenn es keinen Elternrahmen gibt. requestId-
Ein
string. Die ID der Anfrage. Anfrage-IDs sind innerhalb einer Browsersitzung einzigartig. tabId-
Eine
number. Die ID des Tabs, in dem die Anfrage stattfindet. Auf-1gesetzt, wenn die Anfrage nicht mit einem Tab in Zusammenhang steht. type-
ResourceType. Der Ressourcentyp der Anfrage. url-
Ein
string. Die URL der Anfrage.
rule-
MatchedRule. Details einer übereinstimmenden Regel.
Browser-Kompatibilität
Loading…