updateSessionRules method

Future<void> updateSessionRules(
  1. UpdateRuleOptions options
)

Modifies the current set of session scoped 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 not persisted across sessions and are backed in memory.
  • [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, and others.

Implementation

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