The type of certificate error that was overridden for this connection, if any.
Protocol version if state is "secure"
Describes the current status of the stream.
An array of HTTP headers. Each header is represented as a dictionary containing the keys name and either value or binaryValue.
Tracking flags that match our internal tracking classification
If the request has been classified this is an array of UrlClassificationFlags.
ConstMAX_The maximum number of times that handlerBehaviorChanged can be called per 10 minute sustained interval. handlerBehaviorChanged is an expensive function call that shouldn't be called often.
ConstonFired when an authentication failure is received. The listener has three options: it can provide authentication credentials, it can cancel the request and display the error page, or it can take no action on the challenge. If bad user credentials are provided, this may be called multiple times for the same request.
ConstonFired when a server-initiated redirect is about to occur.
ConstonFired when a request is about to occur.
ConstonFired before sending an HTTP request, once the request headers are available. This may occur after a TCP connection is made to the server, but before any HTTP data is sent.
ConstonFired when a request is completed.
ConstonFired when an error occurs.
ConstonFired when HTTP response headers of a request have been received.
ConstonFired when the first byte of the response body is received. For HTTP requests, this means that the status line and response headers are available.
ConstonFired just before a request is going to be sent to the server (modifications of previous onBeforeSendHeaders callbacks are visible by the time onSendHeaders is fired).
Retrieves the security information for the request. Returns a promise that will resolve to a SecurityInfo object.
Optionaloptions: _GetSecurityInfoOptionsNeeds to be called when the behavior of the webRequest handlers has changed to prevent incorrect handling due to caching. This function call is expensive. Don't call it often.
Use the
browser.webRequestAPI to observe and analyze traffic and to intercept, block, or modify requests in-flight.Permissions:
webRequestNot allowed in: Content scripts, Devtools pages