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

BCD tables only load in the browser