declarativeNetRequest.updateEnabledRulesets()
Aktualisiert die aktivierten statischen Regelsätze der Erweiterung. Zuerst werden die Regelsätze mit den in options.disableRulesetIds aufgeführten IDs deaktiviert. Anschließend werden die in options.enableRulesetIds aufgeführten Regelsätze aktiviert. Die Auswahl der aktivierten statischen Regelsätze bleibt über Browsersitzungen hinweg erhalten, jedoch nicht bei Aktualisierungen der Erweiterung. Bei jeder Aktualisierung der Erweiterung bestimmt der Manifest-Schlüssel declarative_net_request.rule_resources, welche statischen Regelsätze aktiviert sind.
Hinweis:
In Firefox 132 und älteren Versionen 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). Als Behelfslösung stellen Sie sicher, dass der Manifest-Schlüssel declarative_net_request mindestens einen aktivierten Regelsatz enthält.
Syntax
let updatedRulesets = browser.declarativeNetRequest.updateEnabledRulesets(
options // object
);
Parameter
options-
Ein Objekt, das angibt, welche statischen Regelsätze der Erweiterung aktiviert oder deaktiviert werden sollen.
disableRulesetIdsOptional-
Ein Array von
string-Werten. IDs der statischen Regelsätze, die deaktiviert werden sollen. enableRulesetIdsOptional-
Ein Array von
string-Werten. IDs der statischen Regelsätze, die aktiviert werden sollen.
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.