declarativeNetRequest.updateEnabledRulesets
Aktualisiert den Satz von statischen Regelwerken der Erweiterung. Die Regelwerke mit den in options.disableRulesetIds aufgeführten IDs werden zuerst deaktiviert, und dann die in options.enableRulesetIds aufgeführten Regelwerke aktiviert. Beachten Sie, dass der Satz der aktivierten statischen Regelwerke über Sitzungen hinweg beibehalten wird, aber nicht über Erweiterungsaktualisierungen, d.h. der declarative_net_request.rule_resources Manifest-Schlüssel bestimmt den Satz der aktivierten statischen Regelwerke bei jedem Update der Erweiterung.
Hinweis:
In Firefox 132 und früher werden statische Regelwerke nach einem Browser-Neustart nicht geladen, wenn zum Installationszeitpunkt keine statischen oder dynamischen Regeln registriert sind (Firefox Fehler 1921353). Eine Umgehungsmöglichkeit besteht darin sicherzustellen, dass der declarative_net_request Manifest-Schlüssel mindestens ein aktiviertes Regelwerk enthält.
Syntax
let updatedRulesets = browser.declarativeNetRequest.updateEnabledRulesets(
options // object
);
Parameter
options-
Ein Objekt, das die Regelwerke beschreibt, die in den statischen Regelwerken der Erweiterung aktiviert oder deaktiviert werden sollen.
disableRulesetIdsOptional-
Ein Array von
string. IDs der statischen Regelwerke, die deaktiviert werden sollen. enableRulesetIdsOptional-
Ein Array von
string. IDs der statischen Regelwerke, die aktiviert werden sollen.
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.