The object describing the actions to take for matching requests. These can be specified in the static rule resources linked by the manifest.json's declarative_net_request key, or more dynamically through the declarativeNetRequest.updateDynamicRules or declarativeNetRequest.updateSessionRules methods.

See Rules on the API overview page for more information about rules.


Values of this type are objects. They contain these properties:


declarativeNetRequest.RuleAction. The action to take if this rule is matched.


declarativeNetRequest.RuleCondition. The condition under which this rule is triggered.


number. An ID that uniquely identifies a rule within a ruleset. Mandatory and should be >= 1.

priority Optional

number. Rule priority. Defaults to 1. When specified, should be >= 1. See Matching precedents for details on how priority affects which rules are applied.

Example extensions

Browser compatibility

BCD tables only load in the browser