Suppose an extension's job is to block web requests against a pattern, and the following scenario happens:
Because the page will be reloaded from the memory cache, the listener may not be called again, and the request will be loaded despite the extension's new policy.
The handlerBehaviorChanged()
function is designed to address this problem. It flushes the in-memory cache, so that page reloads will trigger event listeners.
Because handlerBehaviorChanged()
flushes the cache, it can be expensive and bad for performance. The webRequest module defines a read-only property MAX_HANDLER_BEHAVIOR_CHANGED_CALLS_PER_10_MINUTES
: making more calls than this number in 10 minutes will have no effect.
The implementation of caching, hence the need for this function, varies from one browser to another, so in some browsers this function does nothing.
This is an asynchronous function that returns a Promise
.
var flushingCache = browser.webRequest.handlerBehaviorChanged()
None.
A Promise
that will be fulfilled with no arguments, when the operation has completed.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
handlerBehaviorChanged |
Yes |
14 |
45 |
? |
Yes |
No |
? |
? |
48 |
? |
? |
? |
In the following snippet, we flush the in-memory cache via a call to handlerBehaviorChanged()
, and report this action by logging an appropriate message to the console.
function onFlushed() { console.log(`In-memory cache flushed`); } function onError(error) { console.log(`Error: ${error}`); } var flushingCache = browser.webRequest.handlerBehaviorChanged(); flushingCache.then(onFlushed, onError);
Note: This API is based on Chromium's chrome.webRequest
API. This documentation is derived from web_request.json
in the Chromium code.
Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.
© 2005–2021 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/webRequest/handlerBehaviorChanged