webRequest.handlerBehaviorChanged()

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

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

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

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

Функция handlerBehaviorChanged() предназначена для решения этой проблемы. Она очищает кэш оперативной памяти, так что перезагрузки страниц будут вызывать обработчики событий.

Поскольку handlerBehaviorChanged() очищает кэш, это может быть ресурсоёмким и негативно сказываться на производительности. Модуль webRequest определяет свойство только для чтения MAX_HANDLER_BEHAVIOR_CHANGED_CALLS_PER_10_MINUTES: выполнение большего количества вызовов, чем указано в этом свойстве, в течение 10 минут не окажет никакого влияния.

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

Это асинхронная функция, которая возвращает Promise.

let flushingCache = browser.webRequest.handlerBehaviorChanged()

function onFlushed() {
  console.log(`In-memory cache flushed`);
}

function onError(error) {
  console.log(`Error: ${error}`);
}

let flushingCache = browser.webRequest.handlerBehaviorChanged();
flushingCache.then(onFlushed, onError);