Skip to content

Commit

Permalink
Further info re Safari plus various fixes
Browse files Browse the repository at this point in the history
  • Loading branch information
rebloor committed Jun 18, 2024
1 parent ad35d53 commit 888459f
Show file tree
Hide file tree
Showing 8 changed files with 24 additions and 19 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ browser-compat: webextensions.api.declarativeNetRequest.getSessionRules

{{AddonSidebar}}

Returns the active set of session scoped rules for the extension.
Returns the active set of session-scoped rules for the extension.

## Syntax

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -109,9 +109,8 @@ An extension can:

The number of dynamic and session-scoped rules an extension can add is limited to:

- Up to Chrome 119 and Firefox 127, the value of {{WebExtAPIRef("declarativeNetRequest.MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES","MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES")}}.
- From Chrome 120 and Firefox 128, the values of {{WebExtAPIRef("declarativeNetRequest.MAX_NUMBER_OF_DYNAMIC_RULES","
MAX_NUMBER_OF_DYNAMIC_RULES")}} and {{WebExtAPIRef("declarativeNetRequest.MAX_NUMBER_OF_SESSION_RULES","MAX_NUMBER_OF_SESSION_RULES")}}
- In Safari and up to Chrome 119 and Firefox 127, the value of {{WebExtAPIRef("declarativeNetRequest.MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES","MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES")}}.
- From Chrome 120 and Firefox 128, the values of {{WebExtAPIRef("declarativeNetRequest.MAX_NUMBER_OF_DYNAMIC_RULES","MAX_NUMBER_OF_DYNAMIC_RULES")}} and {{WebExtAPIRef("declarativeNetRequest.MAX_NUMBER_OF_SESSION_RULES","MAX_NUMBER_OF_SESSION_RULES")}}

## Matching precedents

Expand Down Expand Up @@ -193,15 +192,15 @@ If the request was not blocked or redirected, the matching `modifyHeaders` actio
- {{WebExtAPIRef("declarativeNetRequest.MAX_GETMATCHEDRULES_CALLS_PER_INTERVAL")}}
- : The number of times {{WebExtAPIRef("declarativeNetRequest.getMatchedRules")}} can be called within a period of {{WebExtAPIRef("declarativeNetRequest.GETMATCHEDRULES_QUOTA_INTERVAL")}}.
- {{WebExtAPIRef("declarativeNetRequest.MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES")}} {{deprecated_inline}}
- : The maximum number of combined dynamic and session scoped rules an extension can add.
- : The maximum number of combined dynamic and session-scoped rules an extension can add.
- {{WebExtAPIRef("declarativeNetRequest.MAX_NUMBER_OF_DYNAMIC_RULES")}}
- : The maximum number of dynamic rules an extension can add.
- {{WebExtAPIRef("declarativeNetRequest.MAX_NUMBER_OF_ENABLED_STATIC_RULESETS")}}
- : The maximum number of static rulesets an extension can enable.
- {{WebExtAPIRef("declarativeNetRequest.MAX_NUMBER_OF_REGEX_RULES")}}
- : The maximum number of regular expression rules that an extension can add.
- {{WebExtAPIRef("declarativeNetRequest.MAX_NUMBER_OF_SESSION_RULES")}}
- : The maximum number of session scoped rules an extension can add.
- : The maximum number of session-scoped rules an extension can add.
- {{WebExtAPIRef("declarativeNetRequest.MAX_NUMBER_OF_STATIC_RULESETS")}}
- : The maximum number of static rulesets an extension can specify as part of the [`declarative_net_request.rule_resources`](/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/declarative_net_request) manifest key.
- {{WebExtAPIRef("declarativeNetRequest.SESSION_RULESET_ID")}}
Expand All @@ -220,7 +219,7 @@ If the request was not blocked or redirected, the matching `modifyHeaders` actio
- {{WebExtAPIRef("declarativeNetRequest.getMatchedRules()")}}
- : Returns all the rules matched for the extension.
- {{WebExtAPIRef("declarativeNetRequest.getSessionRules()")}}
- : Returns the set of session scoped rules for the extension.
- : Returns the set of session-scoped rules for the extension.
- {{WebExtAPIRef("declarativeNetRequest.isRegexSupported()")}}
- : Checks if a regular expression is supported as a {{WebExtAPIRef("declarativeNetRequest.RuleCondition")}}`.regexFilter` rule condition.
- {{WebExtAPIRef("declarativeNetRequest.setExtensionActionOptions()")}}
Expand All @@ -232,7 +231,7 @@ If the request was not blocked or redirected, the matching `modifyHeaders` actio
- {{WebExtAPIRef("declarativeNetRequest.updateEnabledRulesets()")}}
- : Updates the set of active static rulesets for the extension.
- {{WebExtAPIRef("declarativeNetRequest.updateSessionRules()")}}
- : Modifies the set of session scoped rules for the extension.
- : Modifies the set of session-scoped rules for the extension.
- {{WebExtAPIRef("declarativeNetRequest.updateStaticRules()")}}
- : Modifies the enabled state of rules in a static ruleset.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,15 +7,19 @@ browser-compat: webextensions.api.declarativeNetRequest.MAX_NUMBER_OF_DYNAMIC_AN

{{AddonSidebar}}

The maximum number of combined dynamic and session scoped rules an extension can add.
The maximum number of combined dynamic and session-scoped rules an extension can add.

> **Note:** This property is **deprecated** in favor of {{WebExtAPIRef("declarativeNetRequest.MAX_NUMBER_OF_DYNAMIC_RULES")}} and {{WebExtAPIRef("declarativeNetRequest.MAX_NUMBER_OF_SESSION_RULES")}}.
In Chrome, this limit is enforced for the combination of dynamic and session scoped rules.
In Chrome and Safari, this limit is enforced for the combination of dynamic and session-scoped rules.

In Firefox, each ruleset has its own quota.

Its value is `5000`.
This limit is:

- in Firefox: `5000`
- in Chrome: `30000`
- in Safari: `30000`

{{WebExtExamples("h2")}}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,8 +11,8 @@ The maximum number of dynamic rules an extension can add.

This limit is:

- in Chrome: `30000`
- in Firefox: `5000`
- in Chrome: `30000`

{{WebExtExamples("h2")}}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ browser-compat: webextensions.api.declarativeNetRequest.MAX_NUMBER_OF_REGEX_RULE

The maximum number of regular expression rules that an extension can add.

In Chrome, its value is 1000, and this limit is evaluated separately for the set of dynamic and session rules, and those specified in the rule resources file.
In Chrome, its value is 1000, and this limit is evaluated separately for the set of dynamic and session-scoped rules, and those specified in the rule resources file.

In Firefox, this limit is evaluated separately per ruleset.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,12 +7,12 @@ browser-compat: webextensions.api.declarativeNetRequest.MAX_NUMBER_OF_SESSION_RU

{{AddonSidebar}}

The maximum number of session scoped rules an extension can add.
The maximum number of session-scoped rules an extension can add.

This limit is:

- in Chrome: `5000`
- in Firefox: `5000`
- in Chrome: `5000`

{{WebExtExamples("h2")}}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,9 @@ Modifies the set of dynamic rules for the extension. The rules with IDs listed i
- This update happens as an atomic operation: either all specified rules are added and removed, or an error is returned.
- These rules are persisted across browser sessions and across extension updates.
- Static rules specified as part of the extension package can not be removed using this function.
- Up to Chrome 119 and Firefox 127, the maximum number of dynamic and session rules an extension can add is limited to the value of {{WebExtAPIRef("declarativeNetRequest.MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES","MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES")}}.
- From Chrome 120 and Firefox 128, the maximum number of dynamic rules an extension can add is limited to the value of {{WebExtAPIRef("declarativeNetRequest.MAX_NUMBER_OF_DYNAMIC_RULES","MAX_NUMBER_OF_DYNAMIC_RULES")}}.
- The number of rules that can be added is limited:
- In Safari and up to Chrome 119 and Firefox 127, to the value of {{WebExtAPIRef("declarativeNetRequest.MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES","MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES")}} for the combined total of dynamic and session-scoped rules.
- From Chrome 120 and Firefox 128, to the value of {{WebExtAPIRef("declarativeNetRequest.MAX_NUMBER_OF_DYNAMIC_RULES","MAX_NUMBER_OF_DYNAMIC_RULES")}} for dynamic rules alone.

## Syntax

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,8 +11,9 @@ Modifies the set of scoped rules for the extension. The rules with IDs listed in

- This update happens as an atomic operation: either all specified rules are added and removed, or an error is returned.
- These rules are not persisted across browser sessions.
- Up to Chrome 119 and Firefox 127, the maximum number of dynamic and session rules an extension can add is limited to the value of {{WebExtAPIRef("declarativeNetRequest.MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES","MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES")}}.
- From Chrome 120 and Firefox 128, the maximum number of session rules an extension can add is limited to the value of {{WebExtAPIRef("declarativeNetRequest.MAX_NUMBER_OF_SESSION_RULES","MAX_NUMBER_OF_SESSION_RULES")}}.
- The number of rules that can be added is limited:
- In Safari and up to Chrome 119 and Firefox 127, to the value of {{WebExtAPIRef("declarativeNetRequest.MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES","MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES")}} for the combined total of dynamic and session-scoped rules.
- From Chrome 120 and Firefox 128, to the value of {{WebExtAPIRef("declarativeNetRequest.MAX_NUMBER_OF_SESSION_RULES","MAX_NUMBER_OF_SESSION_RULES")}} for session-scoped rules alone.

## Syntax

Expand Down

0 comments on commit 888459f

Please sign in to comment.