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_AND_SESSION_RULES] is the maximum number of combined dynamic and session rules an extension can add.
|callback|: Called once the update is complete or has failed. In case of an error, [runtime.lastError] will be set 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 promiseToFuture<void>(
      $js.chrome.declarativeNetRequest.updateDynamicRules(options.toJS));
}