declarativeNetRequest.updateSessionRules

Modifiziert die Menge der sitzungsbezogenen Regeln für die Erweiterung. Die Regeln mit den in options.removeRuleIds aufgeführten IDs werden zuerst entfernt und dann 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 werden über Browser-Sitzungen hinweg nicht gespeichert.
  • Die Anzahl der sitzungsbezogenen Regeln, die hinzugefügt werden können, ist begrenzt:

Syntax

js
let rulesetUpdated = browser.declarativeNetRequest.updateSessionRules(
    options                // object
);

Parameter

options

Ein Objekt, das Details der hinzuzufügenden oder aus den dynamischen Regeln zu löschenden Regeln enthält.

addRules Optional

Ein Array von declarativeNetRequest.Rule. Details der 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. Wenn die Anfrage fehlschlägt, wird das Promise mit einer Fehlermeldung abgelehnt.

Beispiele

Beispielerweiterungen

Browser-Kompatibilität