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:
- In Safari und bis Chrome 119 auf den Wert von
MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES
für die kombinierte Gesamtzahl von dynamischen und sitzungsgebundenen Regeln. - Bis Firefox 127 auf den Wert von
MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES
. - Ab Chrome 120 und Firefox 128 auf den Wert von
MAX_NUMBER_OF_SESSION_RULES
.
- In Safari und bis Chrome 119 auf den Wert von
Syntax
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
Beispiel-Erweiterungen
Browser-Kompatibilität
BCD tables only load in the browser