declarativeNetRequest.getMatchedRules()
Gibt alle Regeln zurück, die für die Erweiterung übereingestimmt haben. Aufrufende können die Liste mit einem filter einschränken. Diese Methode steht nur Erweiterungen zur Verfügung, die über die Berechtigung "declarativeNetRequestFeedback" verfügen oder denen die Berechtigung activeTab für die in filter angegebene tabId erteilt wurde. Regeln, die keinem aktiven Dokument zugeordnet sind und vor mehr als fünf Minuten übereingestimmt haben, werden nicht zurückgegeben.
Syntax
let gettingMatchedRules = await browser.declarativeNetRequest.getMatchedRules(
filter // object
);
Parameter
filterOptional-
Ein Objekt zum Filtern der Liste übereinstimmender Regeln.
minTimeStampOptional-
Ein
number. Falls angegeben, werden nur Regeln zurückgegeben, die nach dem angegebenen Zeitstempel übereingestimmt haben. tabIdOptional-
Ein
number. Falls angegeben, werden nur Regeln für den angegebenen Tab zurückgegeben. Bei-1werden Regeln berücksichtigt, die keinem aktiven Tab zugeordnet sind.
Rückgabewert
Eine Promise, die mit einem Objekt mit den folgenden Eigenschaften erfüllt wird:
rule-
declarativeNetRequest.MatchedRule. Details zu einer übereinstimmenden Regel. tabId-
numberDietabIddes Tabs, von dem die Anfrage ausging, sofern der Tab noch aktiv ist. Andernfalls-1. timeStamp-
numberDer Zeitpunkt, zu dem die Regel übereingestimmt hat. Zeitstempel entsprechen der JavaScript-Konvention für Zeitangaben, also der Anzahl der Millisekunden seit der Epoche.
Wenn keine Regeln übereingestimmt haben, ist das Objekt leer. Schlägt die Anfrage fehl, wird die Promise mit einer Fehlermeldung zurückgewiesen.