Spec-Zone.ru › Web Extensions

declarativeNetRequest.updateDynamicRules

Изменяет набор динамических правил для расширения. Правила с идентификаторами, указанными в options.removeRuleIds, сначала удаляются, а затем добавляются правила, указанные в options.addRules. Обратите внимание, что:

  • Это обновление происходит как атомарная операция: либо все указанные правила добавляются и удаляются, либо возвращается ошибка.
  • Эти правила сохраняются между сеансами браузера и обновлениями расширения.
  • Статические правила, указанные в составе пакета расширения, не могут быть удалены с помощью этой функции.
  • declarativeNetRequest.MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES — максимальное количество динамических и сеансовых правил, которые может добавить расширение.

Синтаксис

let updatedRules = browser.declarativeNetRequest.updateDynamicRules(
    options                // object
);

Параметры

options

Объект, содержащий детали правил для добавления или удаления из динамических правил.

addRules Необязательно

Массив declarativeNetRequest.Rule. Детали правил для добавления.

removeRuleIds Необязательно

Массив number. Идентификаторы правил для удаления. Любые неверные идентификаторы игнорируются.

Возвращаемое значение

A Promise Если запрос выполнен успешно, обещание выполняется без аргументов. Если запрос завершился ошибкой, обещание отклоняется с сообщением об ошибке.

Примеры

Совместимость с браузерами

Рабочий стол Мобильный
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox для Android Opera Android Safari на IOS Samsung Internet
updateDynamicRules 84 84 Нет ? 70 15.4 ? ? Нет ? 15.4 ?

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/declarativeNetRequest/updateDynamicRules

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API