chrome.declarativeNetRequest

Описание

API chrome.declarativeNetRequest используется для блокировки или изменения сетевых запросов путём указания декларативных правил. Это позволяет расширениям изменять сетевые запросы, не перехватывая их и не просматривая их содержимое, обеспечивая тем самым большую конфиденциальность.

Разрешения

declarativeNetRequest
declarativeNetRequestWithHostAccess

Разрешения « declarativeNetRequest » и « declarativeNetRequestWithHostAccess » предоставляют одинаковые возможности. Различия между ними заключаются в том, когда разрешения запрашиваются или предоставляются.

"declarativeNetRequest"
Вызывает предупреждение о нехватке прав доступа во время установки, но предоставляет неявный доступ к правилам allow , allowAllRequests и block . Используйте это по возможности, чтобы избежать необходимости запрашивать полный доступ к хостам.
"declarativeNetRequestFeedback"
Включает функции отладки для распакованных расширений , в частности getMatchedRules() и onRuleMatchedDebug .
"declarativeNetRequestWithHostAccess"
Предупреждение о наличии прав доступа не отображается во время установки, но перед выполнением каких-либо действий на хосте необходимо запросить разрешения. Это удобно, если вы хотите использовать декларативные правила сетевых запросов в расширении, у которого уже есть разрешения на доступ к хосту, без генерации дополнительных предупреждений.

Доступность

Хром 84+

Манифест

Помимо описанных ранее разрешений, некоторые типы наборов правил, в частности статические, требуют объявления ключа манифеста "declarative_net_request" , который должен представлять собой словарь с единственным ключом "rule_resources" . Этот ключ представляет собой массив, содержащий словари типа Ruleset , как показано ниже. (Обратите внимание, что имя «Ruleset» не отображается в JSON-коде манифеста, поскольку это всего лишь массив.) Статические наборы правил рассматриваются далее в этом документе.

{
  "name": "My extension",
  ...

  "declarative_net_request" : {
    "rule_resources" : [{
      "id": "ruleset_1",
      "enabled": true,
      "path": "rules_1.json"
    }, {
      "id": "ruleset_2",
      "enabled": false,
      "path": "rules_2.json"
    }]
  },
  "permissions": [
    "declarativeNetRequest",
    "declarativeNetRequestFeedback"
  ],
  "host_permissions": [
    "http://www.blogger.com/*",
    "http://*.google.com/*"
  ],
  ...
}

Правила и наборы правил

Чтобы использовать этот API, укажите один или несколько наборов правил. Набор правил содержит массив правил. Каждое правило выполняет одно из следующих действий:

  • Блокировать сетевой запрос.
  • Обновите схему (с http на https).
  • Предотвратите блокировку запроса, отменив все соответствующие правила блокировки.
  • Перенаправление сетевого запроса.
  • Измените заголовки запроса или ответа.

Существует три типа наборов правил, управление которыми немного различается.

Динамичный
Сохраняются между сеансами браузера и обновлениями расширений и управляются с помощью JavaScript, пока используется расширение.
Сессия
Сбрасывается при закрытии браузера и установке новой версии расширения. Правила сеанса управляются с помощью JavaScript, пока используется расширение.
Статичный
Упаковывается, устанавливается и обновляется при установке или обновлении расширения. Статические правила хранятся в файлах правил в формате JSON и перечислены в файле манифеста.

Динамические и сеансовые наборы правил

Во время использования расширения динамические и сеансовые наборы правил управляются с помощью JavaScript.

  • Динамические правила сохраняются во всех сеансах браузера и обновлениях расширений.
  • Правила сеанса очищаются при закрытии браузера и установке новой версии расширения.

Существует только один тип каждого набора правил. Расширение может динамически добавлять или удалять правила, вызывая updateDynamicRules() и updateSessionRules() , при условии, что ограничения правил не превышаются. Подробнее об ограничениях правил см. в разделе Ограничения правил . Пример можно увидеть в разделе Примеры кода .

Статические наборы правил

В отличие от динамических и сеансовых правил, статические правила упаковываются, устанавливаются и обновляются при установке или обновлении расширения. Они хранятся в файлах правил в формате JSON, которые указываются расширению с помощью ключей "declarative_net_request" и "rule_resources" , как описано выше , а также одного или нескольких словарей наборов Ruleset . Словарь Ruleset содержит путь к файлу правил, идентификатор набора правил в файле и информацию о том, включен или отключен набор правил. Последние два параметра важны при программном включении или отключении набора правил.

{
  ...
  "declarative_net_request" : {
    "rule_resources" : [{
      "id": "ruleset_1",
      "enabled": true,
      "path": "rules_1.json"
    },
    ...
    ]
  }
  ...
}

Для проверки файлов правил загрузите распакованное расширение . Ошибки и предупреждения о недействительных статических правилах отображаются только для распакованных расширений. Недействительные статические правила в упакованных расширениях игнорируются.

Ускоренное рассмотрение

Изменения в статических наборах правил могут быть рассмотрены в ускоренном порядке. См. информацию об ускоренном рассмотрении изменений .

Включение и отключение статических правил и наборов правил

Как отдельные статические правила, так и полные статические наборы правил могут быть включены или отключены во время выполнения.

Набор включённых статических правил и наборов правил сохраняется между сеансами браузера. Ни те, ни другие не сохраняются при обновлениях расширений, то есть после обновления доступны только те правила, которые вы решили оставить в файлах правил.

Из соображений производительности также существуют ограничения на количество правил и наборов правил, которые можно включить одновременно. Вызовите метод getAvailableStaticRuleCount() чтобы проверить количество дополнительных правил, которые можно включить. Сведения об ограничениях правил см. в разделе Ограничения правил .

Чтобы включить или отключить статические правила , вызовите updateStaticRules() . Этот метод принимает объект UpdateStaticRulesOptions , содержащий массивы идентификаторов правил, которые нужно включить или отключить. Идентификаторы определяются с помощью ключа "id" словаря Ruleset . Максимальное количество отключенных статических правил — 5000.

Чтобы включить или отключить статические наборы правил , вызовите метод updateEnabledRulesets() . Этот метод принимает объект UpdateRulesetOptions , содержащий массивы идентификаторов наборов правил, которые нужно включить или отключить. Идентификаторы определяются с помощью ключа "id" словаря Ruleset .

Правила сборки

Независимо от типа, правило начинается с четырёх полей, как показано ниже. Ключи "id" и "priority" принимают числовое значение, а ключи "action" и "condition" могут содержать несколько условий блокировки и перенаправления. Следующее правило блокирует все запросы скриптов, исходящие с "foo.com" к любому URL-адресу с подстрокой "abc" .

{
  "id" : 1,
  "priority": 1,
  "action" : { "type" : "block" },
  "condition" : {
    "urlFilter" : "abc",
    "initiatorDomains" : ["foo.com"],
    "resourceTypes" : ["script"]
  }
}

URL-сопоставление

Декларативный сетевой запрос предоставляет возможность сопоставлять URL-адреса либо с помощью синтаксиса сопоставления с шаблоном, либо с помощью регулярных выражений.

Синтаксис фильтра URL

Ключ "condition" правила позволяет ключу "urlFilter" действовать над URL-адресами в указанном домене. Шаблоны создаются с помощью токенов сопоставления с шаблонами . Вот несколько примеров.

urlFilter Спички Не совпадает
"abc" https://abcd.com
https://example.com/abcd		 https://ab.com
"abc*d" https://abcd.com
https://example.com/abcxyzd		 https://abc.com
"||a.example.com" https://a.example.com/
https://baexample.com/xyz
https://a.example.company		 https://example.com/
"|https*" https://example.com http://example.com/
http://https.com
"example*^123|" https://example.com/123
http://abc.com/example?123		 https://example.com/1234
https://abc.com/example0123

Регулярные выражения

Условия также могут использовать регулярные выражения. См. раздел "regexFilter" . Чтобы узнать об ограничениях, применяемых к этим условиям, см. раздел «Правила, использующие регулярные выражения» .

Напишите хорошие условия URL

Будьте внимательны при написании правил, чтобы они всегда соответствовали всему домену. В противном случае ваше правило может сработать в неожиданных ситуациях. Например, при использовании синтаксиса сопоставления с шаблоном:

  • google.com неверно соответствует https://example.com/?param=google.com
  • ||google.com неверно соответствует https://google.company
  • https://www.google.com неверно соответствует https://example.com/?param=https://www.google.com

Рассмотрите возможность использования:

  • ||google.com/ , который соответствует всем путям и всем поддоменам.
  • |https://www.google.com/ , который соответствует всем путям и не содержит поддоменов.

Аналогично, используйте символы ^ и / для привязки регулярного выражения. Например, ^https:\/\/www\.google\.com\/ соответствует любому пути на https://www.google.com.

Оценка правил

Правила DNR применяются браузером на различных этапах жизненного цикла сетевого запроса.

Перед запросом

Перед выполнением запроса расширение может заблокировать или перенаправить его (включая обновление схемы с HTTP на HTTPS) с помощью соответствующего правила.

Для каждого расширения браузер определяет список соответствующих правил. Правила с действием modifyHeaders здесь не включены, так как они будут обработаны позже. Кроме того, правила с условием responseHeaders будут рассмотрены позже (когда заголовки ответа станут доступны) и не включены.

Затем для каждого расширения Chrome выбирает не более одного кандидата на запрос. Chrome находит соответствующее правило, упорядочивая все соответствующие правила по приоритету. Правила с одинаковым приоритетом сортируются по действию ( allow или allowAllRequests > block > upgradeScheme > redirect ).

Если кандидатом является правило allow или allowAllRequests или фрейм, в котором сделан запрос, ранее соответствовал правилу allowAllRequests с более высоким или равным приоритетом из этого расширения, запрос «разрешается», и расширение не окажет на него никакого влияния.

Если несколько расширений хотят заблокировать или перенаправить этот запрос, выбирается одно действие. Chrome сортирует правила в block order > redirect или upgradeScheme > allow или allowAllRequests . Если два правила относятся к одному типу, Chrome выбирает правило из последнего установленного расширения.

Перед отправкой заголовков запроса

Прежде чем Chrome отправит заголовки запроса на сервер, заголовки обновляются на основе соответствующих правил modifyHeaders .

В рамках одного расширения Chrome формирует список изменений, которые необходимо выполнить, находя все соответствующие правила modifyHeaders . Как и раньше, включаются только правила с более высоким приоритетом, чем любые соответствующие правила allow или allowAllRequests .

Chrome применяет эти правила в таком порядке, что правила из недавно установленного расширения всегда применяются раньше правил из более старого расширения. Кроме того, правила с более высоким приоритетом из одного расширения всегда применяются раньше правил с более низким приоритетом из того же расширения. Примечательно, что даже между расширениями:

  • Если правило добавляется к заголовку, то правила с более низким приоритетом могут добавляться только к этому заголовку. Операции установки и удаления не допускаются.
  • Если правило устанавливает заголовок, то к нему могут быть добавлены только правила с более низким приоритетом из того же расширения. Другие изменения не допускаются.
  • Если правило удаляет заголовок, то правила с более низким приоритетом не могут дальше изменять заголовок.

После получения ответа

После получения заголовков ответа Chrome оценивает правила с условием responseHeaders .

После сортировки этих правил по action и priority и исключения любых правил, которые стали избыточными из-за соответствующего правила allow или allowAllRequests (это происходит идентично шагам в разделе «Перед запросом»), Chrome может заблокировать или перенаправить запрос от имени расширения.

Обратите внимание: если запрос дошёл до этого этапа, он уже отправлен на сервер, и сервер получил данные, подобные телу запроса. Правило блокировки или перенаправления с условием в заголовках ответа всё равно будет работать, но не сможет фактически заблокировать или перенаправить запрос.

В случае правила блокировки это обрабатывается страницей, отправившей запрос, которая получает заблокированный ответ, и Chrome досрочно завершает запрос. В случае правила перенаправления Chrome отправляет новый запрос на перенаправленный URL. Убедитесь, что такое поведение соответствует требованиям конфиденциальности вашего расширения.

Если запрос не заблокирован или не перенаправлен, Chrome применяет все правила modifyHeaders . Изменение заголовков ответа происходит так же, как описано в разделе «До отправки заголовков запроса». Изменение заголовков запроса ни к чему не приводит, поскольку запрос уже был отправлен.

Правила безопасности

Безопасные правила определяются как правила с действием block , allow , allowAllRequests или upgradeScheme . На эти правила распространяется увеличенная динамическая квота правил.

Пределы правил

Загрузка и оценка правил в браузере снижает производительность, поэтому при использовании API действуют некоторые ограничения. Ограничения зависят от типа используемого правила.

Статические правила

Статические правила — это правила, указанные в файлах правил, объявленных в файле манифеста. Расширение может указать до 100 статических наборов правил в рамках ключа манифеста "rule_resources" , но только 50 из этих наборов правил могут быть включены одновременно. Последнее называется MAX_NUMBER_OF_ENABLED_STATIC_RULESETS . В совокупности для этих наборов правил гарантировано не менее 30 000 правил. Это называется GUARANTEED_MINIMUM_STATIC_RULES .

Количество доступных правил после этого зависит от того, сколько правил включено во всех расширениях, установленных в браузере пользователя. Это число можно узнать во время выполнения, вызвав метод getAvailableStaticRuleCount() . Пример можно увидеть в разделе «Примеры кода» .

Правила сеанса

Расширение может содержать до 5000 правил сеанса. Это отображается как MAX_NUMBER_OF_SESSION_RULES .

До Chrome 120 существовало ограничение в 5000 комбинированных динамических и сеансовых правил.

Динамические правила

Расширение может содержать не менее 5000 динамических правил. Это отображается как MAX_NUMBER_OF_UNSAFE_DYNAMIC_RULES .

Начиная с Chrome 121, для безопасных динамических правил доступно большее ограничение — 30 000 правил, которое отображается как MAX_NUMBER_OF_DYNAMIC_RULES . Любые небезопасные правила, добавленные в пределах лимита в 5000, также будут учитываться при подсчёте этого ограничения.

До Chrome 120 существовало ограничение в 5000 комбинированных динамических и сеансовых правил.

Правила, использующие регулярные выражения

Все типы правил могут использовать регулярные выражения; однако общее количество правил регулярных выражений каждого типа не может превышать 1000. Это называется MAX_NUMBER_OF_REGEX_RULES .

Кроме того, размер каждого правила после компиляции должен быть менее 2 КБ. Это примерно соответствует сложности правила. При попытке загрузить правило, превышающее этот лимит, вы увидите предупреждение, подобное следующему, и правило будет проигнорировано.

rules_1.json: Rule with id 1 specified a more complex regex than allowed
as part of the "regexFilter" key.

Взаимодействие с работниками сферы услуг

Запрос declarativeNetRequest применяется только к запросам, достигающим сетевого стека. Это включает ответы из HTTP-кеша, но может не включать ответы, проходящие через обработчик onfetch сервис-воркера. Запрос declarativeNetRequest не повлияет на ответы, сгенерированные сервис-воркером или извлеченные из CacheStorage , но повлияет на вызовы fetch() выполняемые в сервис-воркере.

Доступные в Интернете ресурсы

Правило declarativeNetRequest не может перенаправить запрос публичного ресурса на ресурс, недоступный через Интернет. Это приводит к ошибке. Это справедливо даже в том случае, если указанный ресурс, доступный через Интернет, принадлежит расширению, выполняющему перенаправление. Чтобы объявить ресурсы для declarativeNetRequest, используйте массив "web_accessible_resources" манифеста.

Модификация заголовка

Операция добавления поддерживается только для следующих заголовков запроса: accept , accept-encoding , accept-language , access-control-request-headers , cache-control , connection , content-language , cookie , forwarded , if-match , if-none-match , keep-alive , range , te , trailer , transfer-encoding , upgrade , user-agent , via , want-digest , x-forwarded-for . Этот список разрешенных значений чувствителен к регистру ( ошибка 449152902 ).

При добавлении к заголовку запроса или ответа браузер будет использовать соответствующий разделитель, где это возможно.

Примеры

Примеры кода

Обновление динамических правил

В следующем примере показано, как вызвать updateDynamicRules() . Процедура для updateSessionRules() та же.

// Get arrays containing new and old rules
const newRules = await getNewRules();
const oldRules = await chrome.declarativeNetRequest.getDynamicRules();
const oldRuleIds = oldRules.map(rule => rule.id);

// Use the arrays to update the dynamic rules
await chrome.declarativeNetRequest.updateDynamicRules({
  removeRuleIds: oldRuleIds,
  addRules: newRules
});

Обновление статических наборов правил

В следующем примере показано, как включить и отключить наборы правил с учётом количества доступных и максимально допустимого количества включённых статических наборов правил. Это можно сделать, когда количество необходимых статических правил превышает допустимое. Для этого некоторые наборы правил должны быть установлены, а некоторые — отключены (установив параметр "Enabled" в значение false в файле манифеста).

async function updateStaticRules(enableRulesetIds, disableCandidateIds) {
  // Create the options structure for the call to updateEnabledRulesets()
  let options = { enableRulesetIds: enableRulesetIds }
  // Get the number of enabled static rules
  const enabledStaticCount = await chrome.declarativeNetRequest.getEnabledRulesets();
  // Compare rule counts to determine if anything needs to be disabled so that
  // new rules can be enabled
  const proposedCount = enableRulesetIds.length;
  if (enabledStaticCount + proposedCount > chrome.declarativeNetRequest.MAX_NUMBER_OF_ENABLED_STATIC_RULESETS) {
    options.disableRulesetIds = disableCandidateIds
  }
  // Update the enabled static rules
  await chrome.declarativeNetRequest.updateEnabledRulesets(options);
}

Примеры правил

Следующие примеры иллюстрируют, как Chrome определяет приоритет правил в расширении. При их просмотре вы можете открыть правила определения приоритета в отдельном окне.

Клавиша «приоритет»

Для этих примеров требуется разрешение хоста на *://*.example.com/* .

Чтобы определить приоритет конкретного URL-адреса, проверьте ключи "priority" (определённые разработчиком), "action" и "urlFilter" . Эти примеры относятся к файлу правил, приведённому ниже.

Переход на https://google.com
На этот URL распространяются два правила: правила с идентификаторами 1 и 4. Правило с идентификатором 1 применяется, поскольку действия "block" имеют более высокий приоритет, чем действия "redirect" . Остальные правила не применяются, поскольку они предназначены для более длинных URL.
Переход на https://google.com/1234
Из-за более длинного URL-адреса теперь применяется правило с идентификатором 2 в дополнение к правилам с идентификаторами 1 и 4. Правило с идентификатором 2 применяется, поскольку "allow" имеет более высокий приоритет, чем "block" и "redirect" .
Переход на https://google.com/12345
Все четыре правила соответствуют этому URL. Правило с идентификатором 3 применяется, поскольку его приоритет, заданный разработчиком, является наивысшим в группе. 
[
  {
    "id": 1,
    "priority": 1,
    "action": { "type": "block" },
    "condition": {"urlFilter": "||google.com/", "resourceTypes": ["main_frame"] }
  },
  {
    "id": 2,
    "priority": 1,
    "action": { "type": "allow" },
    "condition": { "urlFilter": "||google.com/123", "resourceTypes": ["main_frame"] }
  },
  {
    "id": 3,
    "priority": 2,
    "action": { "type": "block" },
    "condition": { "urlFilter": "||google.com/12345", "resourceTypes": ["main_frame"] }
  },
  {
    "id": 4,
    "priority": 1,
    "action": { "type": "redirect", "redirect": { "url": "https://example.com" } },
    "condition": { "urlFilter": "||google.com/", "resourceTypes": ["main_frame"] }
  },
]

Перенаправления

В примере ниже требуется разрешение хоста на *://*.example.com/* .

В следующем примере показано, как перенаправить запрос с example.com на страницу внутри самого расширения. Путь расширения /a.jpg преобразуется в chrome-extension://EXTENSION_ID/a.jpg , где EXTENSION_ID — это идентификатор вашего расширения. Для этого в манифесте необходимо указать /a.jpg как доступный веб-ресурс .

{
  "id": 1,
  "priority": 1,
  "action": { "type": "redirect", "redirect": { "extensionPath": "/a.jpg" } },
  "condition": {
    "urlFilter": "||https://www.example.com/",
    "resourceTypes": ["main_frame"]
  }
}

В следующем примере ключ "transform" используется для перенаправления на поддомен example.com. Он использует якорь доменного имени («||») для перехвата запросов с любой схемой от example.com. Ключ "scheme" в "transform" указывает, что перенаправления на поддомен всегда будут использовать протокол «https».

{
  "id": 1,
  "priority": 1,
  "action": {
    "type": "redirect",
    "redirect": {
      "transform": { "scheme": "https", "host": "new.example.com" }
    }
  },
  "condition": {
    "urlFilter": "||example.com/",
    "resourceTypes": ["main_frame"]
  }
}

В следующем примере регулярные выражения используются для перенаправления с https://www.abc.xyz.com/path на https://abc.xyz.com/path . Обратите внимание, что в ключе "regexFilter" точки экранируются, а группа захвата выбирает "abc" или "def". Ключ "regexSubstitution" указывает первое возвращённое совпадение регулярного выражения с помощью "\1". В этом случае "abc" извлекается из перенаправленного URL и добавляется в подстановку. 

{
  "id": 1,
  "priority": 1,
  "action": {
    "type": "redirect",
    "redirect": {
      "regexSubstitution": "https://\\1.xyz.com/"
    }
  },
  "condition": {
    "regexFilter": "^https://www\\.(abc|def)\\.xyz\\.com/",
    "resourceTypes": [
      "main_frame"
    ]
  }
}

Заголовки

В следующем примере удаляются все файлы cookie как из основного фрейма, так и из всех подфреймов. 

{
  "id": 1,
  "priority": 1,
  "action": {
    "type": "modifyHeaders",
    "requestHeaders": [{ "header": "cookie", "operation": "remove" }]
  },
  "condition": { "resourceTypes": ["main_frame", "sub_frame"] }
}

Типы

DomainType

Это определяет, является ли запрос первичным или сторонним по отношению к фрейму, из которого он был создан. Запрос считается первичным, если он имеет тот же домен (eTLD+1), что и фрейм, из которого он был создан.

Перечисление

"firstParty"
Сетевой запрос является первым участником кадра, в котором он возник.

"третья сторона"
Сетевой запрос является третьим по отношению к фрейму, в котором он возник.

ExtensionActionOptions

Хром 88+

Характеристики

  • displayActionCountAsBadgeText

    логическое необязательное

    Отображать ли автоматически количество действий на странице в тексте значка расширения. Эта настройка сохраняется между сеансами.

  • вкладкаОбновление

    TabActionCountUpdate необязательно

    Хром 89+

    Подробная информация о том, как следует корректировать количество действий вкладки.

GetDisabledRuleIdsOptions

Хром 111+

Характеристики

  • rulesetId

    нить

    Идентификатор, соответствующий статическому Ruleset .

GetRulesFilter

Хром 111+

Характеристики

  • идентификаторы правил

    номер[] необязательно

    Если указано, включаются только правила с совпадающими идентификаторами.

HeaderInfo

Хром 128+

Характеристики

  • исключенные значения

    строка[] необязательная

    Если указано, это условие не выполняется, если заголовок существует, но его значение содержит хотя бы один элемент из этого списка. Используется тот же синтаксис шаблона сопоставления, что и values .

  • заголовок

    нить

    Имя заголовка. Это условие выполняется только в том случае, если не указаны ни values , ни excludedValues .

  • ценности

    строка[] необязательная

    Если указано, это условие выполняется, если значение заголовка соответствует хотя бы одному шаблону из этого списка. Поддерживается сопоставление значений заголовков без учёта регистра, а также следующие конструкции:

    '*' : Соответствует любому количеству символов.

    '?' : Соответствует нулю или одному символу(ам).

    Символы «*» и «?» можно экранировать обратной косой чертой, например, «\*» и «\?».

HeaderOperation

Хром 86+

Здесь описываются возможные операции для правила «modifyHeaders».

Перечисление

"добавить"
Добавляет новую запись для указанного заголовка. При изменении заголовков запроса эта операция поддерживается только для определённых заголовков .

"набор"
Устанавливает новое значение для указанного заголовка, удаляя все существующие заголовки с тем же именем.

"удалять"
Удаляет все записи для указанного заголовка.

IsRegexSupportedResult

Хром 87+

Характеристики

  • поддерживается

    булев

  • причина

    Необязательный параметр UnsupportedRegexReason

    Указывает причину, по которой регулярное выражение не поддерживается. Доступно только в том случае, если isSupported равно false.

MatchedRule

Характеристики

  • ruleId

    число

    Идентификатор правила сопоставления.

  • rulesetId

    нить

    Идентификатор Ruleset к которому принадлежит данное правило. Для правила, созданного из набора динамических правил, этот идентификатор будет равен DYNAMIC_RULESET_ID .

MatchedRuleInfo

Характеристики

  • правило

    MatchedRule

  • tabId

    число

    TabId вкладки, с которой был отправлен запрос, если вкладка всё ещё активна. В противном случае -1.

  • отметка времени

    число

    Время срабатывания правила. Временные метки будут соответствовать соглашению Javascript для времени, то есть количеству миллисекунд с начала эпохи.

MatchedRuleInfoDebug

Характеристики

MatchedRulesFilter

Характеристики

  • minTimeStamp

    номер необязательно

    Если указано, сопоставляет только правила после указанной временной метки.

  • tabId

    номер необязательно

    Если указано, сопоставляет только правила для заданной вкладки. Если указано значение -1, сопоставляет правила, не связанные ни с одной активной вкладкой.

ModifyHeaderInfo

Хром 86+

Характеристики

  • заголовок

    нить

    Имя заголовка, который необходимо изменить.

  • Операция, которая должна быть выполнена над заголовком.

  • ценить

    строка необязательная

    Новое значение заголовка. Необходимо указать для операций append и set .

QueryKeyValue

Характеристики

  • ключ

    нить

  • replaceOnly

    логическое необязательное

    Хром 94+

    Если задано значение true, ключ запроса заменяется только в том случае, если он уже присутствует. В противном случае ключ также добавляется, если он отсутствует. Значение по умолчанию — false.

  • ценить

    нить

QueryTransform

Характеристики

  • addOrReplaceParams

    QueryKeyValue [] необязательно

    Список пар ключ-значение запроса, которые необходимо добавить или заменить.

  • removeParams

    строка[] необязательная

    Список ключей запроса, которые необходимо удалить.

Redirect

Характеристики

  • extensionPath

    строка необязательная

    Путь относительно каталога расширения. Должен начинаться с «/».

  • regexПодстановка

    строка необязательная

    Шаблон подстановки для правил, в которых указан фильтр regexFilter . Первое совпадение с фильтром regexFilter в URL будет заменено этим шаблоном. В regexSubstitution для вставки соответствующих групп захвата можно использовать цифры, экранированные обратной косой чертой (от \1 до \9). \0 относится ко всему совпадающему тексту.

  • трансформировать

    URLTransform необязательно

    Преобразования URL для выполнения.

  • URL-адрес

    строка необязательная

    URL-адрес перенаправления. Перенаправления на URL-адреса JavaScript запрещены.

RegexOptions

Хром 87+

Характеристики

  • isCaseSensitive

    логическое необязательное

    Учитывает ли указанное regex ? Значение по умолчанию — true.

  • регулярное выражение

    нить

    Регулярное выражение для проверки.

  • требуетсяЗахват

    логическое необязательное

    Требуется ли захват для указанного regex . Захват требуется только для правил перенаправления, которые определяют действие regexSubstition . Значение по умолчанию — false.

RequestDetails

Характеристики

  • documentId

    строка необязательная

    Хром 106+

    Уникальный идентификатор документа фрейма, если это запрос фрейма.

  • жизненный цикл документа

    DocumentLifecycle (необязательно)

    Хром 106+

    Жизненный цикл документа фрейма, если это запрос на фрейм.

  • frameId

    число

    Значение 0 указывает на то, что запрос выполняется в основном фрейме; положительное значение указывает идентификатор подфрейма, в котором выполняется запрос. Если загружен документ (под)фрейма ( type — main_frame или sub_frame ), frameId указывает идентификатор этого фрейма, а не идентификатор внешнего фрейма. Идентификаторы фреймов уникальны в пределах вкладки.

  • frameType

    FrameType (необязательно)

    Хром 106+

    Тип фрейма, если это запрос фрейма.

  • инициатор

    строка необязательная

    Источник, откуда был инициирован запрос. Не изменяется при перенаправлениях. Если это непрозрачный источник, будет использована строка «null».

  • метод

    нить

    Стандартный метод HTTP.

  • parentDocumentId

    строка необязательная

    Хром 106+

    Уникальный идентификатор родительского документа фрейма, если это запрос фрейма и у него есть родительский документ.

  • parentFrameId

    число

    Идентификатор кадра, который является оболочкой кадра, отправившего запрос. Установите значение -1, если родительского кадра не существует.

  • requestId

    нить

    Идентификатор запроса. Идентификаторы запросов уникальны в пределах сеанса браузера.

  • tabId

    число

    Идентификатор вкладки, в которой выполнен запрос. Установите значение -1, если запрос не связан с вкладкой.

  • Тип ресурса запроса.

  • URL-адрес

    нить

    URL-адрес запроса.

RequestMethod

Хром 91+

Здесь описывается метод HTTP-запроса сетевого запроса.

Перечисление

"соединять"

"удалить"

"получать"

"голова"

"параметры"

"пластырь"

"почта"

"помещать"

"другой"

ResourceType

Здесь описывается тип ресурса сетевого запроса.

Перечисление

"main_frame"

"sub_frame"

"таблица стилей"

"сценарий"

"изображение"

"шрифт"

"объект"

"xmlhttprequest"

"пинг"

"csp_report"

"СМИ"

"вебсокет"

"вебтранспорт"

"webbundle"

"другой"

Rule

Характеристики

  • Действие, которое следует предпринять, если это правило срабатывает.

  • состояние

    ПравилоУсловие

    Условие, при котором срабатывает это правило.

  • идентификатор

    число

    Идентификатор, однозначно определяющий правило. Обязательный и должен быть >= 1.

  • приоритет

    номер необязательно

    Приоритет правила. По умолчанию 1. При указании приоритета должен быть >= 1.

RuleAction

Характеристики

  • перенаправление

    Перенаправление необязательно

    Описывает, как должно выполняться перенаправление. Действительно только для правил перенаправления.

  • requestHeaders

    ModifyHeaderInfo [] необязательно

    Хром 86+

    Заголовки запроса, которые необходимо изменить. Действительно только если RuleActionType — «modifyHeaders».

  • responseHeaders

    ModifyHeaderInfo [] необязательно

    Хром 86+

    Заголовки ответа, которые необходимо изменить для запроса. Действительно только если RuleActionType — «modifyHeaders».

  • Тип действия, которое необходимо выполнить.

RuleActionType

Описывает тип действия, которое следует предпринять, если заданное условие правила совпадает.

Перечисление

"блокировать"
Заблокировать сетевой запрос.

«перенаправление»
Перенаправить сетевой запрос.

"позволять"
Разрешить сетевой запрос. Запрос не будет перехвачен, если есть соответствующее разрешающее правило.

"upgradeScheme"
Обновите схему URL сетевого запроса до https, если запрос — http или ftp.

"modifyHeaders"
Измените заголовки запроса/ответа из сетевого запроса.

"allowAllRequests"
Разрешить все запросы внутри иерархии фрейма, включая сам запрос фрейма.

RuleCondition

Характеристики

  • Тип_домена

    DomainType необязательно

    Указывает, является ли сетевой запрос основным или сторонним по отношению к домену, с которого он был отправлен. Если этот параметр не указан, принимаются все запросы.

  • домены

    строка[] необязательная

    Не рекомендуется с версии Chrome 101

    Вместо этого используйте initiatorDomains

    Правило будет соответствовать только сетевым запросам, исходящим из списка domains .

  • исключенныедомены

    строка[] необязательная

    Не рекомендуется с версии Chrome 101

    Вместо этого используйте excludedInitiatorDomains

    Правило не будет соответствовать сетевым запросам, исходящим из списка excludedDomains .

  • исключенныеInitiatorDomains

    строка[] необязательная

    Хром 101+

    Правило не будет учитывать сетевые запросы, исходящие из списка excludedInitiatorDomains . Если список пуст или отсутствует, домены не исключаются. Это правило имеет приоритет над initiatorDomains .

    Примечания:

    • Также разрешены поддомены типа «a.example.com».
    • Записи должны состоять только из символов ASCII.
    • Используйте кодировку punycode для интернационализированных доменов.
    • Сопоставляется с инициатором запроса, а не с URL-адресом запроса.
    • Поддомены перечисленных доменов также исключены.
  • исключенныеRequestDomains

    строка[] необязательная

    Хром 101+

    Правило не будет учитывать сетевые запросы, если домен соответствует одному из списка excludedRequestDomains . Если список пуст или пропущен, домены не исключаются. Это правило имеет приоритет над requestDomains .

    Примечания:

    • Также разрешены поддомены типа «a.example.com».
    • Записи должны состоять только из символов ASCII.
    • Используйте кодировку punycode для интернационализированных доменов.
    • Поддомены перечисленных доменов также исключены.
  • исключенныеRequestMethods

    RequestMethod [] необязательно

    Хром 91+

    Список методов запроса, которые не будут соответствовать правилу. Необходимо указать только один из requestMethods или excludedRequestMethods . Если не указан ни один из них, будут соответствовать все методы запроса.

  • исключенныеResourceTypes

    ResourceType [] необязательно

    Список типов ресурсов, которые не будут соответствовать правилу. Необходимо указать только один из resourceTypes или excludedResourceTypes . Если не указан ни один из них, блокируются все типы ресурсов, кроме «main_frame».

  • исключенные заголовки ответов

    HeaderInfo [] необязательно

    Хром 128+

    Правило не срабатывает, если запрос соответствует любому условию заголовка ответа в этом списке (если указано). Если указаны оба свойства: excludedResponseHeaders и responseHeaders , то приоритет имеет свойство excludedResponseHeaders .

  • исключенныеTabIds

    номер[] необязательно

    Хром 92+

    Список tabs.Tab.id , которым правило не должно соответствовать. Идентификатор tabs.TAB_ID_NONE исключает запросы, не исходящие из вкладки. Поддерживается только для правил, действующих в рамках сеанса.

  • initiatorDomains

    строка[] необязательная

    Хром 101+

    Правило будет соответствовать только сетевым запросам, исходящим из списка initiatorDomains . Если список не указан, правило применяется к запросам со всех доменов. Пустой список не допускается.

    Примечания:

    • Также разрешены поддомены типа «a.example.com».
    • Записи должны состоять только из символов ASCII.
    • Используйте кодировку punycode для интернационализированных доменов.
    • Сопоставляется с инициатором запроса, а не с URL-адресом запроса.
    • Также сопоставляются поддомены перечисленных доменов.
  • isUrlFilterCaseSensitive

    логическое необязательное

    Чувствителен ли к регистру urlFilter или regexFilter (в зависимости от того, какой из них указан). Значение по умолчанию — false.

  • regexFilter

    строка необязательная

    Регулярное выражение для сопоставления с URL-адресом сетевого запроса. Оно соответствует синтаксису RE2 .

    Примечание: можно указать только один из параметров: urlFilter или regexFilter .

    Примечание: regexFilter должен содержать только символы ASCII. Он сопоставляется с URL-адресом, в котором хост закодирован в формате punycode (в случае интернационализированных доменов), а все остальные символы, не входящие в ASCII, закодированы в формате UTF-8.

  • requestDomains

    строка[] необязательная

    Хром 101+

    Правило будет применяться только к сетевым запросам, если домен совпадает с одним из списка requestDomains . Если список не указан, правило применяется к запросам со всех доменов. Пустой список не допускается.

    Примечания:

    • Также разрешены поддомены типа «a.example.com».
    • Записи должны состоять только из символов ASCII.
    • Используйте кодировку punycode для интернационализированных доменов.
    • Также сопоставляются поддомены перечисленных доменов.
  • requestMethods

    RequestMethod [] необязательно

    Хром 91+

    Список методов HTTP-запросов, которым может соответствовать правило. Пустой список не допускается.

    Примечание: указание условия правила requestMethods также исключит запросы, не являющиеся HTTP(s), тогда как указание excludedRequestMethods не позволит этого сделать.

  • Типы ресурсов

    ResourceType [] необязательно

    Список типов ресурсов, которым может соответствовать правило. Пустой список не допускается.

    Примечание: это необходимо указать для правил allowAllRequests и может включать только типы ресурсов sub_frame и main_frame .

  • responseHeaders

    HeaderInfo [] необязательно

    Хром 128+

    Правило срабатывает, если запрос соответствует любому условию заголовка ответа в этом списке (если указано).

  • tabIds

    номер[] необязательно

    Хром 92+

    Список tabs.Tab.id , которым должно соответствовать правило. Идентификатор tabs.TAB_ID_NONE соответствует запросам, не относящимся к вкладке. Пустой список не допускается. Поддерживается только для правил, действующих в рамках сеанса.

  • URL-фильтр

    строка необязательная

    Шаблон, сопоставляемый с URL-адресом сетевого запроса. Поддерживаемые конструкции:

    '*' : Подстановочный знак: соответствует любому количеству символов.

    '|' : Левый/правый якорь: при использовании в любом из концов шаблона указывает начало/конец URL соответственно.

    '||' : Якорь доменного имени: если используется в начале шаблона, указывает начало (под)домена URL.

    «^» : Символ-разделитель. Соответствует чему угодно, кроме буквы, цифры или одного из следующих символов: _ , - . . или % . Также соответствует концу URL.

    Таким образом, urlFilter состоит из следующих частей: (необязательный левый/доменный якорь) + шаблон + (необязательный правый якорь).

    Если этот параметр пропущен, будут сопоставлены все URL-адреса. Пустая строка не допускается.

    Шаблон, начинающийся с ||* не допускается. Вместо него используйте * .

    Примечание: можно указать только один из параметров: urlFilter или regexFilter .

    Note: The urlFilter must be composed of only ASCII characters. This is matched against a url where the host is encoded in the punycode format (in case of internationalized domains) and any other non-ascii characters are url encoded in utf-8. For example, when the request url is http://abc.рф?q=ф, the urlFilter will be matched against the url http://abc.xn--p1ai/?q=%D1%84.

Ruleset

Характеристики

  • включено

    булев

    Whether the ruleset is enabled by default.

  • идентификатор

    нить

    A non-empty string uniquely identifying the ruleset. IDs beginning with '_' are reserved for internal use.

  • путь

    нить

    The path of the JSON ruleset relative to the extension directory.

RulesMatchedDetails

Характеристики

TabActionCountUpdate

Chrome 89+

Характеристики

  • приращение

    число

    The amount to increment the tab's action count by. Negative values will decrement the count.

  • tabId

    число

    The tab for which to update the action count.

TestMatchOutcomeResult

Chrome 103+

Характеристики

  • matchedRules

    MatchedRule []

    The rules (if any) that match the hypothetical request.

TestMatchRequestDetails

Chrome 103+

Характеристики

  • инициатор

    строка необязательная

    The initiator URL (if any) for the hypothetical request.

  • метод

    RequestMethod optional

    Standard HTTP method of the hypothetical request. Defaults to "get" for HTTP requests and is ignored for non-HTTP requests.

  • responseHeaders

    object optional

    Chrome 129+

    The headers provided by a hypothetical response if the request does not get blocked or redirected before it is sent. Represented as an object which maps a header name to a list of string values. If not specified, the hypothetical response would return empty response headers, which can match rules which match on the non-existence of headers. Eg {"content-type": ["text/html; charset=utf-8", "multipart/form-data"]}

  • tabId

    number optional

    The ID of the tab in which the hypothetical request takes place. Does not need to correspond to a real tab ID. Default is -1, meaning that the request isn't related to a tab.

  • тип

    ResourceType

    The resource type of the hypothetical request.

  • URL-адрес

    нить

    The URL of the hypothetical request.

UnsupportedRegexReason

Chrome 87+

Describes the reason why a given regular expression isn't supported.

Перечисление

"syntaxError"
The regular expression is syntactically incorrect, or uses features not available in the RE2 syntax .

"memoryLimitExceeded"
The regular expression exceeds the memory limit.

UpdateRuleOptions

Chrome 87+

Характеристики

  • addRules

    Rule [] optional

    Rules to add.

  • removeRuleIds

    number[] optional

    IDs of the rules to remove. Any invalid IDs will be ignored.

UpdateRulesetOptions

Chrome 87+

Характеристики

  • disableRulesetIds

    string[] optional

    The set of ids corresponding to a static Ruleset that should be disabled.

  • enableRulesetIds

    string[] optional

    The set of ids corresponding to a static Ruleset that should be enabled.

UpdateStaticRulesOptions

Chrome 111+

Характеристики

  • disableRuleIds

    number[] optional

    Set of ids corresponding to rules in the Ruleset to disable.

  • enableRuleIds

    number[] optional

    Set of ids corresponding to rules in the Ruleset to enable.

  • rulesetId

    нить

    The id corresponding to a static Ruleset .

URLTransform

Характеристики

  • фрагмент

    строка необязательная

    The new fragment for the request. Should be either empty, in which case the existing fragment is cleared; or should begin with '#'.

  • хозяин

    строка необязательная

    The new host for the request.

  • пароль

    строка необязательная

    The new password for the request.

  • путь

    строка необязательная

    The new path for the request. If empty, the existing path is cleared.

  • порт

    строка необязательная

    The new port for the request. If empty, the existing port is cleared.

  • запрос

    строка необязательная

    The new query for the request. Should be either empty, in which case the existing query is cleared; or should begin with '?'.

  • queryTransform

    QueryTransform optional

    Add, remove or replace query key-value pairs.

  • схема

    строка необязательная

    The new scheme for the request. Allowed values are "http", "https", "ftp" and "chrome-extension".

  • имя пользователя

    строка необязательная

    The new username for the request.

Характеристики

DYNAMIC_RULESET_ID

Ruleset ID for the dynamic rules added by the extension.

Ценить

"_dynamic"

GETMATCHEDRULES_QUOTA_INTERVAL

Time interval within which MAX_GETMATCHEDRULES_CALLS_PER_INTERVAL getMatchedRules calls can be made, specified in minutes. Additional calls will fail immediately and set runtime.lastError . Note: getMatchedRules calls associated with a user gesture are exempt from the quota.

Ценить

10

GUARANTEED_MINIMUM_STATIC_RULES

Chrome 89+

The minimum number of static rules guaranteed to an extension across its enabled static rulesets. Any rules above this limit will count towards the global static rule limit .

Ценить

30000

MAX_GETMATCHEDRULES_CALLS_PER_INTERVAL

The number of times getMatchedRules can be called within a period of GETMATCHEDRULES_QUOTA_INTERVAL .

Ценить

20

MAX_NUMBER_OF_DYNAMIC_RULES

The maximum number of dynamic rules that an extension can add.

Ценить

30000

MAX_NUMBER_OF_ENABLED_STATIC_RULESETS

Chrome 94+

The maximum number of static Rulesets an extension can enable at any one time.

Ценить

50

MAX_NUMBER_OF_REGEX_RULES

The maximum number of regular expression rules that an extension can add. This limit is evaluated separately for the set of dynamic rules and those specified in the rule resources file.

Ценить

1000

MAX_NUMBER_OF_SESSION_RULES

Chrome 120+

The maximum number of session scoped rules that an extension can add.

Ценить

5000

MAX_NUMBER_OF_STATIC_RULESETS

The maximum number of static Rulesets an extension can specify as part of the "rule_resources" manifest key.

Ценить

100

MAX_NUMBER_OF_UNSAFE_DYNAMIC_RULES

Chrome 120+

The maximum number of "unsafe" dynamic rules that an extension can add.

Ценить

5000

MAX_NUMBER_OF_UNSAFE_SESSION_RULES

Chrome 120+

The maximum number of "unsafe" session scoped rules that an extension can add.

Ценить

5000

SESSION_RULESET_ID

Chrome 90+

Ruleset ID for the session-scoped rules added by the extension.

Ценить

"_session"

Методы

getAvailableStaticRuleCount()

Chrome 89+
chrome.declarativeNetRequest.getAvailableStaticRuleCount(): Promise<number>

Returns the number of static rules an extension can enable before the global static rule limit is reached.

Возврат

  • Promise<number>

    Chrome 91+

getDisabledRuleIds()

Chrome 111+
chrome.declarativeNetRequest.getDisabledRuleIds(
  options: GetDisabledRuleIdsOptions,
): Promise<number[]>

Returns the list of static rules in the given Ruleset that are currently disabled.

Параметры

Возврат

  • Promise<number[]>

getDynamicRules()

chrome.declarativeNetRequest.getDynamicRules(
  filter?: GetRulesFilter,
): Promise<Rule[]>

Returns the current set of dynamic rules for the extension. Callers can optionally filter the list of fetched rules by specifying a filter .

Параметры

  • фильтр

    GetRulesFilter optional

    Chrome 111+

    An object to filter the list of fetched rules.

Возврат

  • Promise< Rule []>

    Chrome 91+

getEnabledRulesets()

chrome.declarativeNetRequest.getEnabledRulesets(): Promise<string[]>

Returns the ids for the current set of enabled static rulesets.

Возврат

  • Promise<string[]>

    Chrome 91+

getMatchedRules()

chrome.declarativeNetRequest.getMatchedRules(
  filter?: MatchedRulesFilter,
): Promise<RulesMatchedDetails>

Returns all rules matched for the extension. Callers can optionally filter the list of matched rules by specifying a filter . This method is only available to extensions with the "declarativeNetRequestFeedback" permission or having the "activeTab" permission granted for the tabId specified in filter . Note: Rules not associated with an active document that were matched more than five minutes ago will not be returned.

Параметры

Возврат

getSessionRules()

Chrome 90+
chrome.declarativeNetRequest.getSessionRules(
  filter?: GetRulesFilter,
): Promise<Rule[]>

Returns the current set of session scoped rules for the extension. Callers can optionally filter the list of fetched rules by specifying a filter .

Параметры

  • фильтр

    GetRulesFilter optional

    Chrome 111+

    An object to filter the list of fetched rules.

Возврат

  • Promise< Rule []>

    Chrome 91+

isRegexSupported()

Chrome 87+
chrome.declarativeNetRequest.isRegexSupported(
  regexOptions: RegexOptions,
): Promise<IsRegexSupportedResult>

Checks if the given regular expression will be supported as a regexFilter rule condition.

Параметры

  • regexOptions

    RegexOptions

    The regular expression to check.

Возврат

setExtensionActionOptions()

Хром 88+
chrome.declarativeNetRequest.setExtensionActionOptions(
  options: ExtensionActionOptions,
): Promise<void>

Configures if the action count for tabs should be displayed as the extension action's badge text and provides a way for that action count to be incremented.

Параметры

Возврат

  • Обещание<void>

    Chrome 91+

testMatchOutcome()

Chrome 103+
chrome.declarativeNetRequest.testMatchOutcome(
  request: TestMatchRequestDetails,
): Promise<TestMatchOutcomeResult>

Checks if any of the extension's declarativeNetRequest rules would match a hypothetical request. Note: Only available for unpacked extensions as this is only intended to be used during extension development.

Параметры

Возврат

updateDynamicRules()

chrome.declarativeNetRequest.updateDynamicRules(
  options: UpdateRuleOptions,
): Promise<void>

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 must not exceed MAX_NUMBER_OF_UNSAFE_DYNAMIC_RULES .

Параметры

Возврат

  • Обещание<void>

    Chrome 91+

updateEnabledRulesets()

chrome.declarativeNetRequest.updateEnabledRulesets(
  options: UpdateRulesetOptions,
): Promise<void>

Updates the set of enabled static rulesets for the extension. The rulesets with IDs listed in options.disableRulesetIds are first removed, and then the rulesets listed in options.enableRulesetIds are added. Note that the set of enabled static rulesets is persisted across sessions but not across extension updates, ie the rule_resources manifest key will determine the set of enabled static rulesets on each extension update.

Параметры

Возврат

  • Обещание<void>

    Chrome 91+

updateSessionRules()

Chrome 90+
chrome.declarativeNetRequest.updateSessionRules(
  options: UpdateRuleOptions,
): Promise<void>

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_SESSION_RULES is the maximum number of session rules an extension can add.

Параметры

Возврат

  • Обещание<void>

    Chrome 91+

updateStaticRules()

Chrome 111+
chrome.declarativeNetRequest.updateStaticRules(
  options: UpdateStaticRulesOptions,
): Promise<void>

Disables and enables individual static rules in a Ruleset . Changes to rules belonging to a disabled Ruleset will take effect the next time that it becomes enabled.

Параметры

Возврат

  • Обещание<void>

События

onRuleMatchedDebug

chrome.declarativeNetRequest.onRuleMatchedDebug.addListener(
  callback: function,
)

Fired when a rule is matched with a request. Only available for unpacked extensions with the "declarativeNetRequestFeedback" permission as this is intended to be used for debugging purposes only.

Параметры