declarativeNetRequest.getMatchedRules

Gibt alle Regeln zurück, die für die Erweiterung übereinstimmen. Aufrufer können die Liste der übereinstimmenden Regeln filtern, indem sie einen filter angeben. Diese Methode ist nur für Erweiterungen mit der Berechtigung "declarativeNetRequestFeedback" verfügbar oder wenn die Berechtigung "activeTab" für die in filter angegebene tabId gewährt wurde. Regeln, die nicht mit einem aktiven Dokument verbunden sind und mehr als fünf Minuten zuvor übereingestimmt wurden, werden nicht zurückgegeben.

Syntax

js
let gettingMatchedRules = browser.declarativeNetRequest.getMatchedRules(
    filter                // object
);

Parameter

filter Optional

Ein Objekt, um die Liste der übereinstimmenden Regeln zu filtern.

minTimeStamp Optional

Eine number. Wenn angegeben, werden nur Regeln nach dem angegebenen Zeitstempel übereinstimmen.

tabId Optional

Eine number. Wenn angegeben, werden nur Regeln für den angegebenen Tab übereinstimmen. Übereinstimmende Regeln, die keinem aktiven Tab zugeordnet sind, wenn auf -1 gesetzt.

Rückgabewert

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

rule

declarativeNetRequest.MatchedRule. Details einer übereinstimmenden Regel.

tabId

number Die tabId des Tabs, von dem die Anfrage stammt, wenn der Tab noch aktiv ist. Andernfalls -1.

timeStamp

number Die Zeit, zu der die Regel übereinstimmte. Zeitstempel entsprechen der JavaScript-Konvention für Zeiten, d.h. der Anzahl der Millisekunden seit der Epoche.

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

Beispiele

Browser-Kompatibilität