declarativeNetRequest.updateEnabledRulesets
Aktualisiert die Menge der statischen Regelsätze der Erweiterung. Die Regelsätze mit den in options.disableRulesetIds
aufgeführten IDs werden zuerst deaktiviert und anschließend die in options.enableRulesetIds
aufgeführten Regelsätze aktiviert. Beachten Sie, dass die Menge der aktivierten statischen Regelsätze zwischen den Sitzungen, jedoch nicht zwischen Erweiterungsaktualisierungen beibehalten wird, d.h. der declarative_net_request.rule_resources
manifest-Schlüssel bestimmt die Menge der aktivierten statischen Regelsätze bei jeder Erweiterungsaktualisierung.
Hinweis:
In Firefox 132 und früher werden statische Regelsätze nicht nach einem Browser-Neustart geladen, wenn zum Installationszeitpunkt keine statischen oder dynamischen Regeln registriert sind (Firefox Bug 1921353). Ein Workaround 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.
disableRulesetIds
Optional-
Ein Array von
string
. IDs der statischen Regelsätze, die deaktiviert werden sollen. enableRulesetIds
Optional-
Ein Array von
string
. IDs der statischen Regelsätze, die aktiviert werden sollen.
Rückgabewert
Ein Promise
Wenn die Anfrage erfolgreich war, wird das Versprechen ohne Argumente erfüllt. Schlägt die Anfrage fehl, wird das Versprechen mit einer Fehlermeldung zurückgewiesen.
Beispiele
>Browser-Kompatibilität
Loading…