Contient des informations sur un proxy. Cet objet, ou un tableau de ces objets, est renvoyé par le programme d'écoute à proxy.onRequest
. Il indique au navigateur si la requête doit être mandatée et, dans l'affirmative, quel proxy utiliser.
Type
Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :
type
-
string
. Cela indique s'il faut utiliser un proxy et, dans l'affirmative, quel type de proxy utiliser. Il peut prendre l'une des valeurs suivantes :"direct"
: ne pas utiliser la requête par procuration. Si cette valeur est donnée, toutes les autres propriétés de cet objet sont ignorées."http"
: HTTP proxy (ou SSL CONNECT pour HTTPS)"https"
: HTTP proxying via TLS connection au proxy"socks"
: proxy SOCKS v5"socks4"
: proxy SOCKS v4
host
string
. Le nom d'hôte du serveur proxy. Obligatoire sauf si letype
est"direct"
.port
string
. e numéro de port du serveur proxy. Obligatoire sauf si letype
est"direct"
.username
string
. Nom d'utilisateur pour le service proxy. Ceci est utilisable avec "socks". Pour les autorisations de proxy HTTP, utilisezwebRequest.onAuthRequired
.password
string
. Mot de passe pour le service proxy. Ceci est utilisable avec "socks". FPour les autorisations de proxy HTTP, utilisezwebRequest.onAuthRequired
.proxyDNS
boolean
. Si vrai, le serveur proxy est utilisé pour résoudre certaines requêtes DNS (uniquement utilisable avec"socks4"
et"socks"
). Par défaut àfalse
.failoverTimeout
number
: Délais de basculement en secondes. Si la connexion ne parvient pas à connecter le serveur proxy après ce nombre de secondes, le serveur proxy suivant dans le tableau renvoyé par l'écouteurproxy.onRequest
sera utilisé.
proxyAuthorizationHeader
string.
Cette chaîne, si elle est définie sur non-vide, est passée directement en valeur à l'en-tête de requêteProxy-Authorization
envoyé aux proxies HTTP dans le cadre des requêtes HTTP ordinaires et des requêtes CONNECT. Simplement dit, ceci peut être utilisé pour s'authentifier directement sur les proxies HTTP nécessitant une authentification (non contestable).
Par exemple, si vous voulez envoyer "nom d'utilisateur" et "mot de passe" pour l'authentification "basique", vous pouvez définir la propriétéproxyAuthorizationHeader
àBasic dXNlcm5hbWU6cGFzc3dvcmQ=
connectionIsolationKey
Facultatifstring.
Une clé optionnelle utilisée pour l'isolation supplémentaire de cette connexion proxy.
Compatibilité du navigateur
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.