declarative_net_request

Typ Object
Verpflichtend Nein
Manifest-Version 2 oder höher
Beispiel
json
"declarative_net_request" : {
  "rule_resources" : [{
    "id": "ruleset",
    "enabled": true,
    "path": "rules.json"
  }]
}

Spezifizieren Sie statische Regelsets zur Verwendung mit declarativeNetRequest. Weitere Informationen zu der Anzahl der Regelsets, aktivierten Regelsets und Regeln, die angegeben werden können, finden Sie unter statische Regelset-Limits.

Weitere Informationen zu den Berechtigungsanforderungen finden Sie unter Berechtigungen.

Hinweis: Eine Regel mit nicht erkannten Eigenschaften wird geladen, wenn sie ansonsten gültig ist, das heißt, nicht erkannte Eigenschaften werden ignoriert. Vor Firefox 128 wurde eine Regel mit nicht erkannten Eigenschaften als ungültig betrachtet und nicht geladen.

Syntax

Der Schlüssel "declarative_net_request" ist ein Objekt, das die Eigenschaft "rule_resources" enthalten muss, ein Array, das mindestens ein Objekt mit diesen Eigenschaften umfassen muss:

Name Typ Beschreibung
"id" String Eine nicht-leere Zeichenkette, die das Regelset eindeutig identifiziert. IDs, die mit '_' beginnen, sind für internen Gebrauch reserviert.
"enabled" Boolean Gibt an, ob das Regelset standardmäßig aktiviert ist. Die Methode declarativeNetRequest.updateEnabledRulesets kann verwendet werden, um ein Regelset zur Laufzeit zu aktivieren oder zu deaktivieren.
"path" String Der Pfad des JSON-Regelsets relativ zum Erweiterungsverzeichnis. Siehe den Abschnitt Regeln der declarativeNetRequest-API für Informationen über den Inhalt der Regelset-JSON-Datei.

Beispiel

json
"declarative_net_request" : {
  "rule_resources" : [{
    "id": "ruleset_1",
    "enabled": true,
    "path": "rules_1.json"
  }, {
    "id": "ruleset_2",
    "enabled": false,
    "path": "rules_2.json"
  }]
}

Beispielerweiterungen

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
declarative_net_request
rule_resources
rule_resources.enabled
rule_resources.id
rule_resources.path

Legend

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

Full support
Full support