webRequest.BlockingResponse

Un objet de ce type est renvoyé par les auditeurs d'événements qui ont défini le "blocking" dans leur argument extraInfoSpec.

En définissant des propriétés particulières dans BlockingResponse, l'auditeur peut modifier les requêtes réseau.

Notez que vous ne pouvez pas définir toutes les propriétés de cet objet dans chaque auditeur : les propriétés que vous pouvez définir dépendent de l'événement qui a déclenché cet auditeur, comme détaillé ci-dessous.

Type

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :

authCredentialsFacultatif

object. Si elle est définie, la demande est faite en utilisant les informations d'identification données. Vous ne pouvez définir cette propriété que dans onAuthRequired. La propriété authCredentials est un objet avec les propriétés suivantes :

username

string. Nom d'utilisateur à fournir.

password

string. Mot de passe à fournir.

cancelFacultatif

boolean. Si true, la demande est annulée. Vous pouvez définir cette propriété seulement dans onBeforeRequest, onBeforeSendHeaders, onHeadersReceived, et onAuthRequired.

redirectUrlFacultatif

string. Il s'agit d'une URL, et si elle est définie, la requête originale est redirigée vers cette URL. Vous ne pouvez définir cette propriété que dans onBeforeRequest ou onHeadersReceived.

Les redirections vers des schémas non-HTTP tels que data : sont autorisées, mais elles ne sont pas prises en charge actuellement (bug Firefox 707624). Les redirections utilisent la même méthode de requête que la requête originale à moins qu'elle ne soit initiée à partir de l'étape onHeadersReceived, auquel cas la redirection utilise la méthode GET.

Si une extension veut rediriger une URL publique (par exemple HTTPS) vers une page d'extension, le fichier manifest.json de l'extension doit contenir une clé web_accessible_resources qui liste l'URL de la page d'extension.

requestHeadersFacultatif

webRequest.HttpHeaders. C'est un objet HttpHeaders, un tableau dans lequel chaque objet représente un en-tête. Si elle est définie, la demande est faite avec ces en-têtes plutôt qu'avec les en-têtes d'origine. Vous ne pouvez définir cette propriété que dans onBeforeSendHeaders .

responseHeadersFacultatif

webRequest.HttpHeaders. C'est un objet HttpHeaders, un tableau dans lequel chaque objet représente un en-tête. Si elle est définie, le serveur est supposé avoir répondu avec ces en-têtes de réponse au lieu des originaux. Vous ne pouvez définir cette propriété que dans onHeadersReceived. Si plusieurs extensions tentent de définir le même en-tête (par exemple, Content-Security-Policy), une seule des modifications sera réussie.

upgradeToSecureFacultatif

boolean. Si la valeur true est est définie et que la requête originale est une requête HTTP, cela empêchera l'envoi de la requête originale et fera plutôt une requête sécurisée (HTTPS). Si une extension renvoie redirectUrl dans onBeforeRequest, alors upgradeToSecure sera ignoré pour cette requête. Vous ne pouvez définir cette propriété que dans onBeforeRequest.

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
BlockingResponse
upgradeToSecure

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

Note :

Cette API est basée sur l'API Chromium chrome.webRequest. Cette documentation est dérivée de web_request.json dans le code Chromium.