declarativeNetRequest.getMatchedRules

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

Syntax

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

Parameter

filter Optional

Ein Objekt zum Filtern der Liste der übereinstimmenden Regeln.

minTimeStamp Optional

Eine number. Falls angegeben, stimmen nur Regeln nach dem angegebenen Zeitstempel überein.

tabId Optional

Eine number. Falls angegeben, stimmen nur Regeln für den angegebenen Tab überein. Stimmen Regeln zu, die mit keinem aktiven Tab verbunden 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 Anforderung stammt, falls der Tab noch aktiv ist. Andernfalls -1.

timeStamp

number Der Zeitpunkt, zu dem die Regel übereinstimmte. Zeitstempel entsprechen der JavaScript-Konvention für Zeiten, d.h. die Anzahl der Millisekunden seit dem Epoch.

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

Beispiele

Browser-Kompatibilität

BCD tables only load in the browser