declarativeNetRequest.updateDynamicRules

Modifiziert die Menge der dynamischen Regeln für die Erweiterung. Die Regeln mit IDs, die in options.removeRuleIds aufgelistet sind, 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 zwischen Browsersitzungen und Erweiterungsaktualisierungen bestehen.
• Statische Regeln, die als Teil des Erweiterungspakets angegeben sind, können mit dieser Funktion nicht entfernt werden.
• Die Anzahl der dynamischen Regeln, die hinzugefügt werden können, ist begrenzt:
  • In Safari und bis zu Chrome 119 auf den Wert von MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES für die kombinierte Gesamtzahl von dynamischen und sitzungsbezogenen Regeln.
  • Bis zu 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_DYNAMIC_RULES.

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