updateDynamicRules method

Future<void> updateDynamicRules(
  1. UpdateRuleOptions options
)

Modifies the current set of dynamic rules for the extension. The rules with IDs listed in options.removeRuleIds are first removed, and then the rules given in options.addRules are added. Notes:

  • This update happens as a single 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.
  • [MAX_NUMBER_OF_DYNAMIC_RULES] is the maximum number of dynamic rules an extension can add. The number of [unsafe rules](#safe_rules) must not exceed [MAX_NUMBER_OF_UNSAFE_DYNAMIC_RULES].
|Returns|: Promise that resolves once the update is complete. In case of an error, the promise will be rejected and no change will be made to the rule set. This can happen for multiple reasons, such as invalid rule format, duplicate rule ID, rule count limit exceeded, internal errors, and others.

Implementation

Future<void> updateDynamicRules(UpdateRuleOptions options) async {
  await $js.chrome.declarativeNetRequest
      .updateDynamicRules(options.toJS)
      .toDart;
}