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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
updateEnabledRulesets

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support