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

js
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