declarativeNetRequest.updateSessionRules

Modifiziert die Sitzungs-Regeln der Erweiterung. Die Regeln mit den in options.removeRuleIds aufgeführten IDs werden zunächst entfernt, und dann werden die in options.addRules angegebenen Regeln hinzugefügt. Beachten Sie:

  • Diese Aktualisierung erfolgt als atomare Operation: Entweder werden alle angegebenen Regeln hinzugefügt und entfernt, oder es wird ein Fehler zurückgegeben.
  • Diese Regeln werden nicht über Browser-Sitzungen hinweg gespeichert.
  • Die Anzahl der sitzungsgebundenen Regeln, die hinzugefügt werden können, ist begrenzt:

Syntax

js
let updatedRuleset = browser.declarativeNetRequest.updateSessionRules(
    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. Ungültige IDs werden ignoriert.

Rückgabewert

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

Beispiele

Beispielerweiterungen

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
updateSessionRules

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support