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 :

`authCredentials`Facultatif

`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.


`cancel`Facultatif

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

`redirectUrl`Facultatif

`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.

`requestHeaders`Facultatif

`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` .

`responseHeaders`Facultatif

`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.

`upgradeToSecure`Facultatif

`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
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

**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.