proxy

Avertissement
Vous ne devez pas utiliser la fonction proxy.register() ou la fonction proxy.unregister() pour enregistrer et supprimer le fichier Proxy Auto-Configuration (PAC).  Cette API était dépréciée dans Firefox 68 et sera supprimée de Firefox 71.

Utilisez l'API proxy pour les requêtes Web proxy. Vous pouvez utiliser l'écouteur d'événement proxy.onRequest} pour intercepter les requêtes web, et retourner un objet qui décrit si et comment les proxyer.

L'avantage de l'approche proxy.onRequest est que le code qui implémente votre stratégie de proxy s'exécute dans le script d'arrière-plan de votre extension pour accéder aux API WebExtension disponibles pour votre extension (y compris, par exemple, l'accès au stockage et au réseau de votre extension APIs comme dns).

En dehors de cette API, les extensions peuvent également utiliser la propriété  browserSettings.proxyConfig pour configurer les paramètres proxy globaux.

Google Chrome fournit une API d'extension également appelée "proxy" qui est fonctionnellement similaire à cette API, dans la mesure où les extensions peuvent l'utiliser pour implémenter une politique de proxy. Cependant, la conception de l'API Chrome est complètement différente de cette API. Étant donné que cette API est incompatible avec l'API de proxy Chrome, cette API est uniquement disponible via l'espace de noms du navigateur.

Pour utiliser cette API, vous devez disposer de la permission "proxy". De plus, lorsque vous voulez intercepter des requêtes, vous avez également besoin de la permission de l'hôte pour les URL des requêtes interceptées

Types

proxy.ProxyInfo
Décrit un proxy.
proxy.RequestDetails

Contient des informations sur une requête Web que le navigateur est sur le point de faire.

Properties

proxy.settings
Obtenir et définir les paramètres de proxy.

Functions

proxy.register()
Enregistre le script proxy donné.
proxy.unregister()
Annule l'inscription du script proxy.

Events

proxy.onError
Lancé lorsque le système rencontre une erreur lors de l'exécution du script PAC ou de l'écouteur onRequest.
proxy.onRequest
Déclenché lorsqu'une requête Web est sur le point d'être effectuée, ce qui donne à l'extension l'opportunité de l'utiliser comme proxy.

Example extensions

Compatibilité du navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
onErrorChrome Aucun support NonEdge Aucun support NonFirefox Support complet 60
Support complet 60
Aucun support 55 — 71
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : onProxyError
Opera Aucun support NonFirefox Android Support complet 60
Support complet 60
Support complet 55
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : onProxyError
onRequestChrome Aucun support NonEdge Aucun support NonFirefox Support complet 60Opera Aucun support NonFirefox Android Support complet 60
ProxyInfoChrome Aucun support NonEdge Aucun support NonFirefox Support complet 60Opera Aucun support NonFirefox Android Support complet 60
RequestDetailsChrome Aucun support NonEdge Aucun support NonFirefox Support complet 60Opera Aucun support NonFirefox Android Support complet 60
register
Obsolète
Chrome Aucun support NonEdge Aucun support NonFirefox Aucun support 56 — 71
Aucun support 56 — 71
Support complet 55
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : registerProxyScript
Opera Aucun support NonFirefox Android Support complet 56
Support complet 56
Support complet 55
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : registerProxyScript
settingsChrome Aucun support NonEdge Aucun support NonFirefox Support complet 60
Notes
Support complet 60
Notes
Notes In version 59, this property was listed as proxyConfig in the browserSettings namespace, but it had a bug that made it mostly unusable.
Opera Aucun support NonFirefox Android Aucun support Non
unregister
Obsolète
Chrome Aucun support NonEdge Aucun support NonFirefox Aucun support 56 — 71Opera Aucun support NonFirefox Android Support complet 56

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
Voir les notes d'implémentation.
Voir les notes d'implémentation.
Cette fonctionnalité utilise un nom non-standard.
Cette fonctionnalité utilise un nom non-standard.