declarativeNetRequest.updateDynamicRules

Modifiziert die Menge der dynamischen Regeln für die Erweiterung. Die Regeln mit den in options.removeRuleIds aufgeführten IDs werden zuerst entfernt, und dann werden die in options.addRules angegebenen Regeln hinzugefügt. Beachten Sie, dass:

  • Dieses Update als atomare Operation erfolgt: Entweder werden alle angegebenen Regeln hinzugefügt und entfernt, oder es wird ein Fehler zurückgegeben.
  • Diese Regeln bleiben über Browsersitzungen und Erweiterungs-Updates hinweg bestehen.
  • Statische Regeln, die als Teil des Erweiterungspakets spezifiziert sind, können mit dieser Funktion nicht entfernt werden.
  • Die Anzahl der hinzufügbaren dynamischen Regeln ist begrenzt:

Hinweis: In Firefox 132 und früher werden dynamische Regeln manchmal nach einem Browser-Neustart nicht angewendet, und Aufrufe dieser API werden mit einem Fehler abgelehnt (Firefox-Bug 1921353). Ein Workaround besteht darin, ein aktiviertes statisches Regelset im declarative_net_request-Manifest-Schlüssel anzugeben. Die Regelset-Datei kann eine leere Liste sein.

Syntax

js
let rulesUpdated = browser.declarativeNetRequest.updateDynamicRules(
    options                // object
);

Parameter

options

Ein Objekt mit Details zu den Regeln, die zu den dynamischen Regeln hinzugefügt oder gelöscht werden sollen.

addRules Optional

Ein Array von declarativeNetRequest.Rule. Details zu den hinzuzufügenden Regeln.

removeRuleIds Optional

Ein Array von number. IDs der zu entfernenden Regeln. Alle ungültigen IDs werden ignoriert.

Rückgabewert

Ein Promise. Wenn die Anfrage erfolgreich war, wird das Promise ohne Argumente erfüllt. Wenn die Anfrage fehlschlägt, wird das Promise mit einer Fehlermeldung abgelehnt.

Beispiele

Beispielerweiterungen

Browser-Kompatibilität