webRequest.BlockingResponse

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.