declarative_net_request

型別 Object
必填
Manifest 版本 2 或更高
示例
json
"declarative_net_request" : {
  "rule_resources" : [{
    "id": "ruleset",
    "enabled": true,
    "path": "rules.json"
  }]
}

declarativeNetRequest 指定靜態規則集。有關規則集數量、已啟用規則集和可指定的規則的資訊,請參閱 靜態規則集限制

有關許可權要求的資訊,請參閱 許可權

注意: 包含未知屬性的規則,如果其他方面有效,則會被載入,即未知屬性會被忽略。在 Firefox 128 之前,包含未知屬性的規則被認為無效且不會被載入。

語法

"declarative_net_request" 鍵是一個物件,該物件必須包含 "rule_resources" 屬性,這是一個數組,必須至少包含一個具有以下屬性的物件:

名稱 型別 描述
"id" String 一個非空字串,唯一標識規則集。以下劃線(`_`)開頭的 ID 保留供內部使用。
"enabled" Boolean 規則集是否預設啟用。可以使用 declarativeNetRequest.updateEnabledRulesets 方法在執行時啟用或停用規則集。
"path" String 規則集 JSON 檔案的路徑,相對於擴充套件目錄。有關規則集 JSON 檔案內容的資訊,請參閱 declarativeNetRequest API 的 規則 部分。

示例

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

擴充套件程式示例

瀏覽器相容性