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