declarativeNetRequest.updateEnabledRulesets
Aktualisiert das Set der statischen Regelsätze der Erweiterung. Die Regelsätze mit den in options.disableRulesetIds aufgeführten IDs werden zuerst deaktiviert, und dann werden die in options.enableRulesetIds aufgeführten Regelsätze aktiviert. Beachten Sie, dass das Set der aktivierten statischen Regelsätze über Sitzungen hinweg erhalten bleibt, jedoch nicht über Erweiterungsaktualisierungen hinweg. Das heißt, der declarative_net_request.rule_resources-Manifest-Schlüssel bestimmt das Set der aktivierten statischen Regelsätze bei jeder Erweiterungsaktualisierung.
Hinweis:
In Firefox 132 und früher werden statische Regelsätze nach einem Neustart des Browsers nicht geladen, wenn zum Zeitpunkt der Installation 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 einen aktivierten Regelsatz enthält.
Syntax
let updatedRulesets = browser.declarativeNetRequest.updateEnabledRulesets(
options // object
);
Parameter
options-
Ein Objekt, das die zu aktivierenden oder zu deaktivierenden Regelsätze in den statischen Regelsätzen der Erweiterung beschreibt.
disableRulesetIdsOptional-
Ein Array von
string. IDs der statischen Regelsätze, die deaktiviert werden sollen. enableRulesetIdsOptional-
Ein Array von
string. IDs der statischen Regelsätze, 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.