declarativeNetRequest.updateSessionRules()
Ändert die sitzungsbezogenen Regeln der Erweiterung. Zuerst werden die Regeln mit den in options.removeRuleIds aufgeführten IDs entfernt. Anschließend werden die in options.addRules angegebenen Regeln hinzugefügt. Beachten Sie Folgendes:
- Diese Aktualisierung erfolgt atomar: Entweder werden alle angegebenen Regeln hinzugefügt und entfernt, oder es wird ein Fehler zurückgegeben.
- Diese Regeln bleiben nicht über Browsersitzungen hinweg erhalten.
- Die Anzahl der sitzungsbezogenen Regeln, die hinzugefügt werden können, ist begrenzt:
- In Safari und bis einschließlich Chrome 119 auf den Wert von
MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULESfür die Gesamtzahl der dynamischen und sitzungsbezogenen Regeln. - Bis einschließlich 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 einschließlich Chrome 119 auf den Wert von
Syntax
js
let rulesetUpdated = browser.declarativeNetRequest.updateSessionRules(
options // object
);
Parameter
options-
Ein Objekt mit Angaben zu den Regeln, die den dynamischen Regeln hinzugefügt oder daraus gelöscht werden sollen.
addRulesOptional-
Ein Array von
declarativeNetRequest.Rule. Angaben zu den hinzuzufügenden Regeln. removeRuleIdsOptional-
Ein Array von
number. IDs der zu entfernenden Regeln. Ungültige IDs werden ignoriert.
Rückgabewert
Eine Promise. Wenn die Anfrage erfolgreich war, wird die Promise ohne Argumente erfüllt. Wenn die Anfrage fehlschlägt, wird die Promise mit einer Fehlermeldung zurückgewiesen.