declarativeNetRequest.updateEnabledRulesets
Aktualisiert die Gruppe statischer Regelwerke der Erweiterung. Die Regelwerke mit den in options.disableRulesetIds
aufgeführten IDs werden zuerst deaktiviert, und dann werden die Regelwerke, die in options.enableRulesetIds
aufgeführt sind, aktiviert. Beachten Sie, dass die Gruppe der aktivierten statischen Regelwerke über Sitzungen hinweg erhalten bleibt, nicht jedoch über Erweiterungsaktualisierungen. Der declarative_net_request.rule_resources
Manifest-Schlüssel bestimmt bei jeder Erweiterungsaktualisierung die Gruppe der aktivierten statischen Regelwerke.
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 Bug 1921353). Eine Umgehungslösung 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 zu aktivierenden oder zu deaktivierenden Regelwerke in den statischen Regelwerken der Erweiterung beschreibt.
disableRulesetIds
Optional-
Ein Array von
string
. IDs der zu deaktivierenden statischen Regelwerke. enableRulesetIds
Optional-
Ein Array von
string
. IDs der zu aktivierenden statischen Regelwerke.
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
Browser-Kompatibilität
BCD tables only load in the browser