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

BCD tables only load in the browser