diff options
Diffstat (limited to 'files/fr/mozilla/add-ons/webextensions/api/proxy')
8 files changed, 310 insertions, 332 deletions
diff --git a/files/fr/mozilla/add-ons/webextensions/api/proxy/index.md b/files/fr/mozilla/add-ons/webextensions/api/proxy/index.md index 00d4ca9642..fc9725aef9 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/proxy/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/proxy/index.md @@ -8,61 +8,50 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/proxy --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<div class="warning"> -<p><strong>Attention :</strong></p> - <p>Vous ne devez pas utiliser la fonction {{WebExtAPIRef("proxy.register()")}} ou la fonction {{WebExtAPIRef("proxy.unregister()")}} pour enregistrer et supprimer le fichier <a href="/fr/Add-ons/WebExtensions/API/proxy/register#PAC_file_specification">Proxy Auto-Configuration (PAC)</a>. Cette API était dépréciée dans Firefox 68 et sera supprimée de Firefox 71.</p> -</div> +> **Attention :** +> +> Vous ne devez pas utiliser la fonction {{WebExtAPIRef("proxy.register()")}} ou la fonction {{WebExtAPIRef("proxy.unregister()")}} pour enregistrer et supprimer le fichier [Proxy Auto-Configuration (PAC)](/fr/Add-ons/WebExtensions/API/proxy/register#PAC_file_specification). Cette API était dépréciée dans Firefox 68 et sera supprimée de Firefox 71. -<p>Utilisez l'API proxy pour les requêtes Web proxy. Vous pouvez utiliser l'écouteur d'événement {{WebExtAPIRef("proxy.onRequest")}}} pour intercepter les requêtes web, et retourner un objet qui décrit si et comment les proxyer.</p> +Utilisez l'API proxy pour les requêtes Web proxy. Vous pouvez utiliser l'écouteur d'événement {{WebExtAPIRef("proxy.onRequest")}}} pour intercepter les requêtes web, et retourner un objet qui décrit si et comment les proxyer. -<p>L'avantage de l'approche <code>proxy.onRequest</code> 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 <code><a href="/fr/Add-ons/WebExtensions/API/storage">stockage</a></code> et au réseau de votre extension APIs comme <code><a href="/fr/Add-ons/WebExtensions/API/dns">dns</a></code>).</p> +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`](/fr/Add-ons/WebExtensions/API/storage) et au réseau de votre extension APIs comme [`dns`](/fr/Add-ons/WebExtensions/API/dns)). -<p>En dehors de cette API, les extensions peuvent également utiliser la propriété <code><a href="/fr/Add-ons/WebExtensions/API/browserSettings/proxyConfig">browserSettings.proxyConfig</a></code> pour configurer les paramètres proxy globaux.</p> +En dehors de cette API, les extensions peuvent également utiliser la propriété [`browserSettings.proxyConfig`](/fr/Add-ons/WebExtensions/API/browserSettings/proxyConfig) pour configurer les paramètres proxy globaux. -<p>Google Chrome fournit <a href="https://developer.chrome.com/extensions/proxy">une API d'extension également appelée "proxy"</a> 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 <code>proxy</code> Chrome, cette API est uniquement disponible via l'espace de noms du <code>navigateur</code>.</p> +Google Chrome fournit [une API d'extension également appelée "proxy"](https://developer.chrome.com/extensions/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`. -<p>Pour utiliser cette API, vous devez disposer de la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "proxy". De plus, lorsque vous voulez intercepter des requêtes, vous avez également besoin de la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions">permission de l'hôte</a> pour les URL des requêtes interceptées</p> +Pour utiliser cette API, vous devez disposer de la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) "proxy". De plus, lorsque vous voulez intercepter des requêtes, vous avez également besoin de la [permission de l'hôte](/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions) pour les URL des requêtes interceptées -<h2 id="Types">Types</h2> +## Types -<dl> - <dt>{{WebExtAPIRef("proxy.ProxyInfo")}}</dt> - <dd>Décrit un proxy.</dd> - <dt>{{WebExtAPIRef("proxy.RequestDetails")}}</dt> - <dd> - <p>Contient des informations sur une requête Web que le navigateur est sur le point de faire.</p> - </dd> -</dl> +- {{WebExtAPIRef("proxy.ProxyInfo")}} + - : Décrit un proxy. +- {{WebExtAPIRef("proxy.RequestDetails")}} + - : Contient des informations sur une requête Web que le navigateur est sur le point de faire. -<h2 id="Properties">Properties</h2> +## Properties -<dl> - <dt>{{WebExtAPIRef("proxy.settings")}}</dt> - <dd>Obtenir et définir les paramètres de proxy.</dd> -</dl> +- {{WebExtAPIRef("proxy.settings")}} + - : Obtenir et définir les paramètres de proxy. -<h2 id="Functions">Functions</h2> +## Functions -<dl> - <dt>{{WebExtAPIRef("proxy.register()")}}</dt> - <dd>Enregistre le script proxy donné.</dd> - <dt>{{WebExtAPIRef("proxy.unregister()")}}</dt> - <dd>Annule l'inscription du script proxy.</dd> -</dl> +- {{WebExtAPIRef("proxy.register()")}} + - : Enregistre le script proxy donné. +- {{WebExtAPIRef("proxy.unregister()")}} + - : Annule l'inscription du script proxy. -<h2 id="Events">Events</h2> +## Events -<dl> - <dt>{{WebExtAPIRef("proxy.onError")}}</dt> - <dd>Lancé lorsque le système rencontre une erreur lors de l'exécution du script PAC ou de l'écouteur <code>onRequest</code>.</dd> - <dt>{{WebExtAPIRef("proxy.onRequest")}}</dt> - <dd>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.</dd> -</dl> +- {{WebExtAPIRef("proxy.onError")}} + - : Lancé lorsque le système rencontre une erreur lors de l'exécution du script PAC ou de l'écouteur `onRequest`. +- {{WebExtAPIRef("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. -<p>{{WebExtExamples("h2")}}</p> +{{WebExtExamples("h2")}} -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +## Compatibilité du navigateur -<p>{{Compat("webextensions.api.proxy")}}</p> +{{Compat("webextensions.api.proxy")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/proxy/onerror/index.md b/files/fr/mozilla/add-ons/webextensions/api/proxy/onerror/index.md index 136451dc85..ae309570bb 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/proxy/onerror/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/proxy/onerror/index.md @@ -12,48 +12,42 @@ tags: translation_of: Mozilla/Add-ons/WebExtensions/API/proxy/onError original_slug: Mozilla/Add-ons/WebExtensions/API/proxy/onProxyError --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Lancé en cas d'erreur lors de l'évaluation du fichier PAC ou l'écouteur <code>onRequest</code>.</p> +Lancé en cas d'erreur lors de l'évaluation du fichier PAC ou l'écouteur `onRequest`. -<p>L'erreur peut être déclenchée en lançant ou renvoyant une valeur invalide dans le gestionnaire d'événements proxy.onRequest.</p> +L'erreur peut être déclenchée en lançant ou renvoyant une valeur invalide dans le gestionnaire d'événements proxy.onRequest. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.proxy.onError.addListener(listener) +```js +browser.proxy.onError.addListener(listener) browser.proxy.onError.removeListener(listener) browser.proxy.onError.hasListener(listener) -</pre> +``` -<p>Les événements ont trois fonctions :</p> +Les événements ont trois fonctions : -<dl> - <dt><code>addListener(listener)</code></dt> - <dd>Ajoute un écouteur à cet événement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>Arrêtez d'écouter cet événement. L'argument <code>listener</code> est l'écouteur à supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>Vérifiez si l'<code>écouteur</code> est enregistré pour cet événement. Renvoie <code>true</code> s'il écoute, sinon <code>false</code>.</dd> -</dl> +- `addListener(listener)` + - : Ajoute un écouteur à cet événement. +- `removeListener(listener)` + - : Arrêtez d'écouter cet événement. L'argument `listener` est l'écouteur à supprimer. +- `hasListener(listener)` + - : Vérifiez si l'`écouteur` est enregistré pour cet événement. Renvoie `true` s'il écoute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelée lorsque cet événement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>newState</code></dt> - <dd><code>Object</code>. Un objet <a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Error">Error</a> représentant l'erreur.</dd> - </dl> - </dd> -</dl> + - : Fonction qui sera appelée lorsque cet événement se produit. La fonction recevra les arguments suivants : -<p>{{WebExtExamples}}</p> + - `newState` + - : `Object`. Un objet [Error](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Error) représentant l'erreur. -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +{{WebExtExamples}} -<p>{{Compat("webextensions.api.proxy.onError")}}</p> +## Compatibilité du navigateur + +{{Compat("webextensions.api.proxy.onError")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/proxy/onrequest/index.md b/files/fr/mozilla/add-ons/webextensions/api/proxy/onrequest/index.md index 209b532f15..90a46bbe63 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/proxy/onrequest/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/proxy/onrequest/index.md @@ -12,83 +12,77 @@ tags: - onRequest translation_of: Mozilla/Add-ons/WebExtensions/API/proxy/onRequest --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Déclenché lorsqu'une requête Web est sur le point d'être effectuée, pour donner à l'extension la possibilité de l'utiliser comme proxy.</p> +Déclenché lorsqu'une requête Web est sur le point d'être effectuée, pour donner à l'extension la possibilité de l'utiliser comme proxy. -<p>Cet événement est étroitement modélisé sur les événements définis dans l'API <code><a href="/fr/Add-ons/WebExtensions/API/webRequest">webRequest</a></code> Comme ces événements, sa fonction <code>addListener()</code> prend trois arguments :</p> +Cet événement est étroitement modélisé sur les événements définis dans l'API [`webRequest`](/fr/Add-ons/WebExtensions/API/webRequest) Comme ces événements, sa fonction `addListener()` prend trois arguments : -<ul> - <li>l'écouteur qui sera appelé lorsque l'événement est déclenché.</li> - <li>Un objet <code><a href="/fr/Add-ons/WebExtensions/API/webRequest/RequestFilter">RequestFilter</a></code> contrôlant quelles requêtes provoquent le déclenchement de l'événement.</li> - <li>un tableau de chaînes pour contrôler d'autres aspects du comportement de l'événement.</li> -</ul> +- l'écouteur qui sera appelé lorsque l'événement est déclenché. +- Un objet [`RequestFilter`](/fr/Add-ons/WebExtensions/API/webRequest/RequestFilter) contrôlant quelles requêtes provoquent le déclenchement de l'événement. +- un tableau de chaînes pour contrôler d'autres aspects du comportement de l'événement. -<p>L'événement est déclenché avant l'un des événements <code>webRequest</code> pour la même demande.</p> +L'événement est déclenché avant l'un des événements `webRequest` pour la même demande. -<p>Lorsque l'événement est déclenché, l'écouteur est appelé avec un objet contenant des informations sur la requête. L'écouteur renvoie un objet {{WebExtAPIRef("proxy.ProxyInfo")}} représentant un proxy à utiliser (ou un tableau de tels objets, permettant au navigateur de basculer si un proxy est inaccessible).</p> +Lorsque l'événement est déclenché, l'écouteur est appelé avec un objet contenant des informations sur la requête. L'écouteur renvoie un objet {{WebExtAPIRef("proxy.ProxyInfo")}} représentant un proxy à utiliser (ou un tableau de tels objets, permettant au navigateur de basculer si un proxy est inaccessible). -<p>Pour utiliser <code>proxy.onRequest</code>, une extension doit avoir la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">permission API</a> "proxy" , ainsi que la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions">permission d'hôte</a> pour les URL des requêtes qu'elle intercepte - ela signifie essentiellement que les modèles de correspondance de l'argument <code>filter</code> doivent être un sous-ensemble de l'extension autorisations de l'hôte.</p> +Pour utiliser `proxy.onRequest`, une extension doit avoir la [permission API](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions) "proxy" , ainsi que la [permission d'hôte](/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions) pour les URL des requêtes qu'elle intercepte - ela signifie essentiellement que les modèles de correspondance de l'argument `filter` doivent être un sous-ensemble de l'extension autorisations de l'hôte. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.proxy.onRequest.addListener( +```js +browser.proxy.onRequest.addListener( listener, // function filter, // object extraInfoSpec // optional array of strings ) browser.proxy.onRequest.removeListener(listener) browser.proxy.onRequest.hasListener(listener) -</pre> +``` -<p>Les événements ont trois fonctions :</p> +Les événements ont trois fonctions : -<dl> - <dt><code>addListener(listener, filter, extraInfoSpec)</code></dt> - <dd>Ajoute un écouteur à cet événement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>Arrêtez d'écouter cet événement. L'argument <code>listener</code> est l'écouteur à supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>Vérifiez si <code>listener</code> est enregistré pour cet événement. Renvoie <code>true</code> s'il écoute, sinon <code>false</code>.</dd> -</dl> +- `addListener(listener, filter, extraInfoSpec)` + - : Ajoute un écouteur à cet événement. +- `removeListener(listener)` + - : Arrêtez d'écouter cet événement. L'argument `listener` est l'écouteur à supprimer. +- `hasListener(listener)` + - : Vérifiez si `listener` est enregistré pour cet événement. Renvoie `true` s'il écoute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>listener</code></dt> - <dd> - <p>Fonction qui sera appelée lorsque cet événement se produit. La fonction passera un seul argument, qui est un objet {{WebExtAPIRef("proxy.RequestDetails")}} contenant les détails de la requête.</p> +- `listener` - <p>L'écouteur peut renvoyer l'un des éléments suivants:</p> + - : Fonction qui sera appelée lorsque cet événement se produit. La fonction passera un seul argument, qui est un objet {{WebExtAPIRef("proxy.RequestDetails")}} contenant les détails de la requête. - <ul> - <li>un objet {{WebExtAPIRef("proxy.ProxyInfo")}}</li> - <li>un tableau d'objets <code>proxy.ProxyInfo</code></li> - <li>Une <code>Promise</code> qui se résout en un objet <code>ProxyInfo</code></li> - <li>Une <code>Promise</code> qui résout en un tableau d'objets <code>ProxyInfo</code>.</li> - </ul> + L'écouteur peut renvoyer l'un des éléments suivants: - <p>Si l'écouteur renvoie un tableau, ou une Promesse qui se résout en un tableau, alors tous les objets<code>ProxyInfo</code> après le premier représentent les basculements: si le proxy à la position N dans le tableau n'est pas accessible quand son <code>ProxyInfo.failoverTimeout</code> alors le navigateur essayez le proxy à la position N+1.</p> + - un objet {{WebExtAPIRef("proxy.ProxyInfo")}} + - un tableau d'objets `proxy.ProxyInfo` + - Une `Promise` qui se résout en un objet `ProxyInfo` + - Une `Promise` qui résout en un tableau d'objets `ProxyInfo`. - <p>S'il y a une erreur spécifiant les objets <code>proxy.ProxyInfo</code> objects, alors {{WebExtAPIRef("proxy.onError")}} sera appelé.</p> - </dd> - <dt><code>filter</code></dt> - <dd>{{WebExtAPIRef('webRequest.RequestFilter')}}. Un ensemble de filtres qui limite les événements qui seront envoyés à cet écouteur.</dd> - <dt><code>extraInfoSpec</code> {{optional_inline}}</dt> - <dd><code>array</code> de <code>string</code>. Options supplémentaires pour l'événement. Vous pouvez passer une seule valeur, <code>"requestHeaders"</code>, pour inclure les en-têtes de demande dans l'objet de <code>details</code> transmis à l'écouteur.</dd> -</dl> + Si l'écouteur renvoie un tableau, ou une Promesse qui se résout en un tableau, alors tous les objets`ProxyInfo` après le premier représentent les basculements: si le proxy à la position N dans le tableau n'est pas accessible quand son `ProxyInfo.failoverTimeout` alors le navigateur essayez le proxy à la position N+1. -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> + S'il y a une erreur spécifiant les objets `proxy.ProxyInfo` objects, alors {{WebExtAPIRef("proxy.onError")}} sera appelé. -<p>{{Compat("webextensions.api.proxy.onRequest", 10)}}</p> +- `filter` + - : {{WebExtAPIRef('webRequest.RequestFilter')}}. Un ensemble de filtres qui limite les événements qui seront envoyés à cet écouteur. +- `extraInfoSpec` {{optional_inline}} + - : `array` de `string`. Options supplémentaires pour l'événement. Vous pouvez passer une seule valeur, `"requestHeaders"`, pour inclure les en-têtes de demande dans l'objet de `details` transmis à l'écouteur. -<h2 id="Exemples">Exemples</h2> +## Compatibilité du navigateur -<p>Ce code intercepte les requêtes à <code><all_urls></code>, et les envoie par procuration si elles ne sont pas destinées à un cadre de premier niveau.</p> +{{Compat("webextensions.api.proxy.onRequest", 10)}} -<pre class="brush: js">function shouldProxyRequest(requestInfo) { +## Exemples + +Ce code intercepte les requêtes à `<all_urls>`, et les envoie par procuration si elles ne sont pas destinées à un cadre de premier niveau. + +```js +function shouldProxyRequest(requestInfo) { return requestInfo.parentFrameId != -1; } @@ -100,6 +94,7 @@ function handleProxyRequest(requestInfo) { return {type: "direct"}; } -browser.proxy.onRequest.addListener(handleProxyRequest, {urls: ["<all_urls>"]});</pre> +browser.proxy.onRequest.addListener(handleProxyRequest, {urls: ["<all_urls>"]}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/proxy/proxyinfo/index.md b/files/fr/mozilla/add-ons/webextensions/api/proxy/proxyinfo/index.md index 2bc4fd359b..42a8cf4a5d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/proxy/proxyinfo/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/proxy/proxyinfo/index.md @@ -10,52 +10,50 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/proxy/ProxyInfo --- -<div>{{AddonSidebar()}}</div> - -<p>Contient des informations sur un proxy. Cet objet, ou un tableau de ces objets, est renvoyé par le programme d'écoute à {{WebExtAPIRef("proxy.onRequest")}}. Il indique au navigateur si la requête doit être mandatée et, dans l'affirmative, quel proxy utiliser.</p> - -<h2 id="Type">Type</h2> - -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :</p> - -<dl> - <dt><code>type</code></dt> - <dd> - <p><code>string</code>. 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 :</p> - - <ul> - <li><code>"direct"</code>: 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.</li> - <li><code>"http"</code>: HTTP proxy (ou SSL CONNECT pour HTTPS)</li> - <li><code>"https"</code>: HTTP proxying via TLS connection au proxy</li> - <li><code>"socks"</code>: proxy SOCKS v5</li> - <li><code>"socks4"</code>: proxy SOCKS v4</li> - </ul> - </dd> - <dt><code>host</code></dt> - <dd><code>string</code>. Le nom d'hôte du serveur proxy. Obligatoire sauf si le <code>type</code> est <code>"direct"</code>.</dd> - <dt><code>port</code></dt> - <dd><code>string</code>. e numéro de port du serveur proxy. Obligatoire sauf si le <code>type</code> est <code>"direct"</code>.</dd> - <dt><code>username</code></dt> - <dd><code>string</code>. Nom d'utilisateur pour le service proxy. Ceci est utilisable avec "socks". Pour les autorisations de proxy HTTP, utilisez <a href="/fr/Add-ons/WebExtensions/API/webRequest/onAuthRequired"><code>webRequest.onAuthRequired</code></a>.</dd> - <dt><code>password</code></dt> - <dd><code>string</code>. Mot de passe pour le service proxy. Ceci est utilisable avec "socks". FPour les autorisations de proxy HTTP, utilisez <a href="/fr/Add-ons/WebExtensions/API/webRequest/onAuthRequired"><code>webRequest.onAuthRequired</code></a>.</dd> - <dt><code>proxyDNS</code></dt> - <dd><code>boolean</code>. Si vrai, le serveur proxy est utilisé pour résoudre certaines requêtes DNS (uniquement utilisable avec <code>"socks4"</code> et <code>"socks"</code>). Par défaut à <code>false</code>.</dd> - <dt><code>failoverTimeout</code></dt> - <dd><code>number</code>: 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'écouteur <code>proxy.onRequest</code> sera utilisé.</dd> -</dl> - -<dl> - <dt><code>proxyAuthorizationHeader</code></dt> - <dd><code>string.</code> Cette chaîne, si elle est définie sur non-vide, est passée directement en valeur à l'en-tête de requête {{httpheader("Proxy-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).<br> - <br> - Par exemple, si vous voulez envoyer "nom d'utilisateur" et "mot de passe" pour l'authentification "basique", vous pouvez définir la propriété <code>proxyAuthorizationHeader</code> à <code>Basic dXNlcm5hbWU6cGFzc3dvcmQ=</code></dd> - <dt><code>connectionIsolationKey </code> {{optional_inline}}</dt> - <dd><code>string.</code> Une clé optionnelle utilisée pour l'isolation supplémentaire de cette connexion proxy.</dd> -</dl> - -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> - -<p>{{Compat("webextensions.api.proxy.ProxyInfo")}}</p> - -<p>{{WebExtExamples}}</p> +{{AddonSidebar()}} + +Contient des informations sur un proxy. Cet objet, ou un tableau de ces objets, est renvoyé par le programme d'écoute à {{WebExtAPIRef("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 le `type` est `"direct"`. +- `port` + - : `string`. e numéro de port du serveur proxy. Obligatoire sauf si le `type` est `"direct"`. +- `username` + - : `string`. Nom d'utilisateur pour le service proxy. Ceci est utilisable avec "socks". Pour les autorisations de proxy HTTP, utilisez [`webRequest.onAuthRequired`](/fr/Add-ons/WebExtensions/API/webRequest/onAuthRequired). +- `password` + - : `string`. Mot de passe pour le service proxy. Ceci est utilisable avec "socks". FPour les autorisations de proxy HTTP, utilisez [`webRequest.onAuthRequired`](/fr/Add-ons/WebExtensions/API/webRequest/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'écouteur `proxy.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ête {{httpheader("Proxy-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 `{{optional_inline}} + - : `string.` Une clé optionnelle utilisée pour l'isolation supplémentaire de cette connexion proxy. + +## Compatibilité du navigateur + +{{Compat("webextensions.api.proxy.ProxyInfo")}} + +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/proxy/register/index.md b/files/fr/mozilla/add-ons/webextensions/api/proxy/register/index.md index 8fe80e8891..8db820818f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/proxy/register/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/proxy/register/index.md @@ -13,35 +13,34 @@ tags: - registerProxyScript translation_of: Mozilla/Add-ons/WebExtensions/API/proxy/register --- -<p>{{AddonSidebar()}} {{deprecated_header}}</p> +{{AddonSidebar()}} {{deprecated_header}} -<p>Cette méthode était obsolète dans Firefox 68 et sera supprimée de Firefox 71. Dans Firefox 68 ou une version ultérieure, l'appel de cette méthode enregistre un message d'erreur sur la console :</p> +Cette méthode était obsolète dans Firefox 68 et sera supprimée de Firefox 71. Dans Firefox 68 ou une version ultérieure, l'appel de cette méthode enregistre un message d'erreur sur la console : -<p><img alt="" src="proxy_register_warning.png"></p> + -<p>Enregistre un <a href="/fr/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_%28PAC%29_file">fichier PAC (Proxy Auto-Configuration)</a>. Le fichier est exécuté immédiatement, et sa fonction <code>FindProxyForURL()</code> sera appelée pour toutes les demandes HTTP, HTTPS ou FTP.</p> +Enregistre un [fichier PAC (Proxy Auto-Configuration)](/fr/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_%28PAC%29_file). Le fichier est exécuté immédiatement, et sa fonction `FindProxyForURL()` sera appelée pour toutes les demandes HTTP, HTTPS ou FTP. -<p>Si les fichiers PAC sont enregistrés par plusieurs extensions, les demandes seront initialement transmises à celle qui a été enregistrée en premier.</p> +Si les fichiers PAC sont enregistrés par plusieurs extensions, les demandes seront initialement transmises à celle qui a été enregistrée en premier. -<ul> - <li>Si la fonction <code>FindProxyForURL()</code> dans le premier PAC renvoie "DIRECT" pour une demande, alors la demande sera transmise inchangée à la fonction <code>FindProxyForURL()</code> dans le prochain PAC.</li> - <li>Si la fonction <code>FindProxyForURL()</code> dans le premier PAC transfère la requête en renvoyant "PROXY" ou une autre valeur proxy, l'URL du proxy sera transmise à la fonction <code>FindProxyForURL()</code> dans le prochain PAC.</li> -</ul> +- Si la fonction `FindProxyForURL()` dans le premier PAC renvoie "DIRECT" pour une demande, alors la demande sera transmise inchangée à la fonction `FindProxyForURL()` dans le prochain PAC. +- Si la fonction `FindProxyForURL()` dans le premier PAC transfère la requête en renvoyant "PROXY" ou une autre valeur proxy, l'URL du proxy sera transmise à la fonction `FindProxyForURL()` dans le prochain PAC. -<p>Chaque extension ne peut enregistrer qu'un seul fichier PAC : si vous appelez <code>register()</code> deux fois, le second fichier PACremplacera le premier.</p> +Chaque extension ne peut enregistrer qu'un seul fichier PAC : si vous appelez `register()` deux fois, le second fichier PACremplacera le premier. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<h2 id="Communiquez_avec_les_fichiers_PAC">Communiquez avec les fichiers PAC</h2> +## Communiquez avec les fichiers PAC -<p>Vous pouvez échanger des messages entre le fichier PAC et la page d'arrière-plan de votre extension (ou toute autre page privilégiée, comme les pages contextuelles) en utilisant <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/runtime/sendMessage">runtime.sendMessage()</a></code> et <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/runtime/onMessage">runtime.onMessage</a></code>.</p> +Vous pouvez échanger des messages entre le fichier PAC et la page d'arrière-plan de votre extension (ou toute autre page privilégiée, comme les pages contextuelles) en utilisant [`runtime.sendMessage()`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/runtime/sendMessage) et [`runtime.onMessage`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/runtime/onMessage). -<p>Pour envoyer un message au fichier PAC, vous devez définir l'option <code>toProxyScript</code> :</p> +Pour envoyer un message au fichier PAC, vous devez définir l'option `toProxyScript` : -<pre class="brush: js">// background.js +```js +// background.js // Log any messages from the proxy. -browser.runtime.onMessage.addListener((message, sender) => { +browser.runtime.onMessage.addListener((message, sender) => { if (sender.url === browser.extension.getURL(proxyScriptURL)) { console.log(message); } @@ -53,31 +52,35 @@ let messageToProxy = { bar: 1234 }; -browser.runtime.sendMessage(messageToProxy, {toProxyScript: true});</pre> +browser.runtime.sendMessage(messageToProxy, {toProxyScript: true}); +``` -<pre class="brush: js">// pac.js +```js +// pac.js -browser.runtime.onMessage.addListener((message) => { +browser.runtime.onMessage.addListener((message) => { if (message.enabled) { browser.runtime.sendMessage("I'm enabled!"); } -});</pre> +}); +``` -<h2 id="Spécification_de_fichier_PAC">Spécification de fichier PAC</h2> +## Spécification de fichier PAC -<p>La syntaxe de base du fichier PAC est décrite dans la <a href="/fr/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_(PAC)_file">documentation PAC</a>, mais l'implémentation utilisée par l'API proxy diffère de la conception PAC standard de différentes manières, décrites dans cette section.</p> +La syntaxe de base du fichier PAC est décrite dans la [documentation PAC](</fr/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_(PAC)_file>), mais l'implémentation utilisée par l'API proxy diffère de la conception PAC standard de différentes manières, décrites dans cette section. -<h3 id="Valeur_retournée_FindProxyForURL">Valeur retournée FindProxyForURL()</h3> +### Valeur retournée FindProxyForURL() -<p>La norme <code>FindProxyForURL()</code> <a href="/fr/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_%28PAC%29_file#Return_value_format">renvoie une chaîne</a>. Dans Firefox 55 et 56, le fichier PAC utilisé avec l'API proxy renvoie également une chaîne. Dans Firefox 55 <em>seulement</em>, vous devez passer un argument à la valeur de retour "DIRECT", même s'il n'a pas besoin d'argument.</p> +La norme `FindProxyForURL()` [renvoie une chaîne](/fr/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_%28PAC%29_file#Return_value_format). Dans Firefox 55 et 56, le fichier PAC utilisé avec l'API proxy renvoie également une chaîne. Dans Firefox 55 _seulement_, vous devez passer un argument à la valeur de retour "DIRECT", même s'il n'a pas besoin d'argument. -<p>À partir de Firefox 57, <code>FindProxyForURL()</code> peut toujours renvoyer une chaîne, mais peut également (et de préférence) renvoyer un tableau d'objets {{WebExtAPIRef("proxy.ProxyInfo")}}.</p> +À partir de Firefox 57, `FindProxyForURL()` peut toujours renvoyer une chaîne, mais peut également (et de préférence) renvoyer un tableau d'objets {{WebExtAPIRef("proxy.ProxyInfo")}}. -<p>Si le tableau contient plus d'un objet, alors tous les objets <code>ProxyInfo</code> après le premier représentent les basculements : si le proxy à la position N dans le tableau n'est pas accessible quand son <code>ProxyInfo.failoverTimeout</code> expire, alors le navigateur essaiera le proxy à la position N + 1.</p> +Si le tableau contient plus d'un objet, alors tous les objets `ProxyInfo` après le premier représentent les basculements : si le proxy à la position N dans le tableau n'est pas accessible quand son `ProxyInfo.failoverTimeout` expire, alors le navigateur essaiera le proxy à la position N + 1. -<p>Par exemple :</p> +Par exemple : -<pre class="brush: js">const proxySpecification = [ +```js +const proxySpecification = [ { type: "socks", host: "foo.com", @@ -90,28 +93,30 @@ browser.runtime.onMessage.addListener((message) => { host: "bar.com", port: 1060, } -];</pre> +]; +``` -<p>Le premier proxy dans le tableau sera essayé en premier. S'il ne répond pas dans <code>failoverTimeout</code> secondes, le prochain sera essayé, jusqu'à ce que la fin du tableau est atteint.</p> +Le premier proxy dans le tableau sera essayé en premier. S'il ne répond pas dans `failoverTimeout` secondes, le prochain sera essayé, jusqu'à ce que la fin du tableau est atteint. -<h3 id="Environnement_du_fichier_PAC">Environnement du fichier PAC</h3> +### Environnement du fichier PAC -<p>Les fonctions globales d'assistance généralement disponibles pour les fichiers PAC (<code><a href="/fr/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_(PAC)_file#isPlainHostName()_2">isPlainHostName()</a></code>, <code><a href="/fr/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_(PAC)_file#dnsDomainIs()">dnsDomainIs()</a></code>, etc) ne sont pas disponibles.</p> +Les fonctions globales d'assistance généralement disponibles pour les fichiers PAC ([`isPlainHostName()`](</fr/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_(PAC)_file#isPlainHostName()_2>), [`dnsDomainIs()`](</fr/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_(PAC)_file#dnsDomainIs()>), etc) ne sont pas disponibles. -<p>Le code qui s'exécute dans le fichier PAC n'a pas accès à :</p> +Le code qui s'exécute dans le fichier PAC n'a pas accès à : -<ul> - <li>outes les fonctions DOM (par exemple, <a href="/fr/docs/Web/API/Window">window</a> ou l'une de ses propriétés)</li> - <li>les API WebExtension sauf <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/runtime/sendMessage">runtime.sendMessage()</a></code> et <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/runtime/onMessage">runtime.onMessage</a></code></li> - <li>l' <a href="/fr/docs/Web/API/Console">API console</a> - pour consigner les messages d'un PAC, envoyez un message au script d'arrière-plan :</li> -</ul> +- outes les fonctions DOM (par exemple, [window](/fr/docs/Web/API/Window) ou l'une de ses propriétés) +- les API WebExtension sauf [`runtime.sendMessage()`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/runtime/sendMessage) et [`runtime.onMessage`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/runtime/onMessage) +- l' [API console](/fr/docs/Web/API/Console) - pour consigner les messages d'un PAC, envoyez un message au script d'arrière-plan : -<pre class="brush: js">// pac.js +```js +// pac.js // send the log message to the background script -browser.runtime.sendMessage(`Proxy-blocker: blocked ${url}`);</pre> +browser.runtime.sendMessage(`Proxy-blocker: blocked ${url}`); +``` -<pre class="brush: js">// background-script.js +```js +// background-script.js function handleMessage(message, sender) { // only handle messages from the proxy script @@ -121,39 +126,40 @@ function handleMessage(message, sender) { console.log(message); } -browser.runtime.onMessage.addListener(handleMessage);</pre> +browser.runtime.onMessage.addListener(handleMessage); +``` -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var registering = browser.proxy.register( +```js +var registering = browser.proxy.register( url // string ) -</pre> - -<h3 id="Paramètres">Paramètres</h3> +``` -<dl> - <dt><code>url</code></dt> - <dd><code>String</code>. URL pointant vers le fichier PAC à charger. Les fichiers PAC doivent être groupés avec l'extension, et l'<code>url</code> doit être relative au fichier <a href="/fr/Add-ons/WebExtensions/manifest.json">manifest.json</a> de l'extension.</dd> -</dl> +### Paramètres -<h3 id="Valeur_retournée">Valeur retournée</h3> +- `url` + - : `String`. URL pointant vers le fichier PAC à charger. Les fichiers PAC doivent être groupés avec l'extension, et l'`url` doit être relative au fichier [manifest.json](/fr/Add-ons/WebExtensions/manifest.json) de l'extension. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie sans argument lorsque le fichier PAC a été enregistré ou rejetée en cas d'erreur.</p> +### Valeur retournée -<h2 id="Exemples">Exemples</h2> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans argument lorsque le fichier PAC a été enregistré ou rejetée en cas d'erreur. -<pre class="brush: js">const proxyScriptURL = "proxy/proxy-script.js"; +## Exemples -browser.proxy.register(proxyScriptURL);</pre> +```js +const proxyScriptURL = "proxy/proxy-script.js"; -<p>{{WebExtExamples}}</p> +browser.proxy.register(proxyScriptURL); +``` -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +{{WebExtExamples}} -<p>{{Compat("webextensions.api.proxy.register")}}</p> +## Compatibilité du navigateur -<div class="note"><p><strong>Note :</strong></p> +{{Compat("webextensions.api.proxy.register")}} -<p>Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.</p> -</div> +> **Note :** +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/proxy/requestdetails/index.md b/files/fr/mozilla/add-ons/webextensions/api/proxy/requestdetails/index.md index 08561e5845..507194e870 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/proxy/requestdetails/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/proxy/requestdetails/index.md @@ -10,49 +10,47 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/proxy/RequestDetails --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Contient des informations sur une requête Web que le navigateur est sur le point de faire. Une instance de cet objet est passée dans l'écouteur {{WebExtAPIRef("proxy.onRequest")}}.</p> +Contient des informations sur une requête Web que le navigateur est sur le point de faire. Une instance de cet objet est passée dans l'écouteur {{WebExtAPIRef("proxy.onRequest")}}. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes : -<dl> - <dt><code>cookieStoreId</code></dt> - <dd><code>string</code>. L'ID de magasin de cookies du contexte actuel.</dd> - <dt><code>documentUrl</code></dt> - <dd><code>string</code>. URL de la page dans laquelle la ressource demandée sera chargée.</dd> - <dt><code>frameId</code></dt> - <dd><code>integer</code>. Zéro si la requête se produit dans le cadre principal; une valeur positive est l'ID d'une sous-trame dans laquelle la requête se produit. Si le document d'une (sous-)frame est chargé (<code>type</code> est <code>main_frame</code> ou <code>sub_frame</code>), <code>frameId</code> indique l'ID de cette trame, pas l'ID de la trame externe. Les ID de cadre sont uniques dans un onglet.</dd> - <dt><code>fromCache</code></dt> - <dd><code>boolean</code>. Indique si cette réponse sera récupérée du cache disque.</dd> - <dt><code>incognito</code></dt> - <dd><code>boolean</code> <code>true</code> pour les demandes de navigation privées</dd> - <dt><code>ip</code></dt> - <dd>L'adresse IP du serveur à laquelle la demande sera envoyée. Notez qu'il peut s'agir d'une adresse IPv6 littérale.</dd> - <dt><code>method</code></dt> - <dd><code>string</code>. Méthode HTTP standard: par exemple, "GET" ou "POST".</dd> - <dt><code>originUrl</code></dt> - <dd><code>string</code>. URL de la ressource qui a déclenché cette demande. Notez que ceci peut ne pas être le même que l'URL de la page dans laquelle la ressource demandée sera chargée. Par exemple, si un document déclenche un chargement dans une fenêtre différente l'<a href="/fr/docs/Web/HTML/Element/a#attr-target">attribut cible d'un lien</a>, ou d'un document CSS inclut une image utilisant la <a href="/fr/docs/Web/CSS/url#The_url()_functional_notation"><code>notation fonctionnelle url()</code></a>, alors ce sera l'URL du document original ou du document CSS, respectivement.</dd> - <dt><code>parentFrameId</code></dt> - <dd><code>integer</code>. ID de l'image qui contient l'image qui a envoyé la demande. Défini sur -1 si aucun cadre parent n'existe.</dd> - <dt><code>requestId</code></dt> - <dd><code>string</code>. L'ID de la demande Les ID de demande sont uniques dans une session de navigateur, vous pouvez donc les utiliser pour associer différents événements associés à la même demande.</dd> - <dt><code>requestHeaders</code>{{optional_inline}}</dt> - <dd>{{WebExtAPIRef('webRequest.HttpHeaders')}}. Les en-têtes de requête HTTP qui vont être envoyés avec cette requête. Notez que ceci n'est inclus que si l'option <code>"requestHeaders"</code> a été passée dans <code>addListener()</code>.</dd> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID de l'onglet dans lequel la requête a lieu. Défini sur -1 si la requête n'est pas liée à un onglet.</dd> - <dt><code>timeStamp</code></dt> - <dd><code>number</code>. L'heure à laquelle cet événement s'est déclenché, en <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'époque</a>.</dd> - <dt><code>type</code></dt> - <dd>{{WebExtAPIRef('webRequest.ResourceType')}}. Le type de ressource demandé : par exemple, "image", "script", "stylesheet".</dd> - <dt><code>url</code></dt> - <dd><code>string</code>. Cible de la demande.</dd> -</dl> +- `cookieStoreId` + - : `string`. L'ID de magasin de cookies du contexte actuel. +- `documentUrl` + - : `string`. URL de la page dans laquelle la ressource demandée sera chargée. +- `frameId` + - : `integer`. Zéro si la requête se produit dans le cadre principal; une valeur positive est l'ID d'une sous-trame dans laquelle la requête se produit. Si le document d'une (sous-)frame est chargé (`type` est `main_frame` ou `sub_frame`), `frameId` indique l'ID de cette trame, pas l'ID de la trame externe. Les ID de cadre sont uniques dans un onglet. +- `fromCache` + - : `boolean`. Indique si cette réponse sera récupérée du cache disque. +- `incognito` + - : `boolean` `true` pour les demandes de navigation privées +- `ip` + - : L'adresse IP du serveur à laquelle la demande sera envoyée. Notez qu'il peut s'agir d'une adresse IPv6 littérale. +- `method` + - : `string`. Méthode HTTP standard: par exemple, "GET" ou "POST". +- `originUrl` + - : `string`. URL de la ressource qui a déclenché cette demande. Notez que ceci peut ne pas être le même que l'URL de la page dans laquelle la ressource demandée sera chargée. Par exemple, si un document déclenche un chargement dans une fenêtre différente l'[attribut cible d'un lien](/fr/docs/Web/HTML/Element/a#attr-target), ou d'un document CSS inclut une image utilisant la [`notation fonctionnelle url()`](</fr/docs/Web/CSS/url#The_url()_functional_notation>), alors ce sera l'URL du document original ou du document CSS, respectivement. +- `parentFrameId` + - : `integer`. ID de l'image qui contient l'image qui a envoyé la demande. Défini sur -1 si aucun cadre parent n'existe. +- `requestId` + - : `string`. L'ID de la demande Les ID de demande sont uniques dans une session de navigateur, vous pouvez donc les utiliser pour associer différents événements associés à la même demande. +- `requestHeaders`{{optional_inline}} + - : {{WebExtAPIRef('webRequest.HttpHeaders')}}. Les en-têtes de requête HTTP qui vont être envoyés avec cette requête. Notez que ceci n'est inclus que si l'option `"requestHeaders"` a été passée dans `addListener()`. +- `tabId` + - : `integer`. ID de l'onglet dans lequel la requête a lieu. Défini sur -1 si la requête n'est pas liée à un onglet. +- `timeStamp` + - : `number`. L'heure à laquelle cet événement s'est déclenché, en [millisecondes depuis l'époque](https://en.wikipedia.org/wiki/Unix_time). +- `type` + - : {{WebExtAPIRef('webRequest.ResourceType')}}. Le type de ressource demandé : par exemple, "image", "script", "stylesheet". +- `url` + - : `string`. Cible de la demande. -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +## Compatibilité du navigateur -<p>{{Compat("webextensions.api.proxy.RequestDetails")}}</p> +{{Compat("webextensions.api.proxy.RequestDetails")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/proxy/settings/index.md b/files/fr/mozilla/add-ons/webextensions/api/proxy/settings/index.md index a2ca638f71..9f5c803494 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/proxy/settings/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/proxy/settings/index.md @@ -13,56 +13,54 @@ tags: translation_of: Mozilla/Add-ons/WebExtensions/API/proxy/settings original_slug: Mozilla/Add-ons/WebExtensions/API/browserSettings/proxyConfig --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} qui peut être utilisé pour modifier les paramètres de proxy du navigateur.</p> +Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} qui peut être utilisé pour modifier les paramètres de proxy du navigateur. -<div class="note"> -<p><strong>Note :</strong> La possibilité de modifier les paramètres de proxy nécessite un accès à une fenêtre privée car les paramètres de proxy affectent à la fois les fenêtres privées et non privées. Par conséquent, si une extension n'a pas reçu l'autorisation de fenêtre privée, les appels à <code>proxy.settings.set()</code> lanceront une exception.</p> -</div> +> **Note :** La possibilité de modifier les paramètres de proxy nécessite un accès à une fenêtre privée car les paramètres de proxy affectent à la fois les fenêtres privées et non privées. Par conséquent, si une extension n'a pas reçu l'autorisation de fenêtre privée, les appels à `proxy.settings.set()` lanceront une exception. -<p>La valeur sous-jacente est un objet avec les propriétés énumérées ci-dessous.</p> +La valeur sous-jacente est un objet avec les propriétés énumérées ci-dessous. -<p>Lors de la définition de cet objet, toutes les propriétés sont facultatives. Notez que les propriétés omises seront réinitialisées à leur valeur par défaut.</p> +Lors de la définition de cet objet, toutes les propriétés sont facultatives. Notez que les propriétés omises seront réinitialisées à leur valeur par défaut. -<dl> - <dt><code>autoConfigUrl</code>{{optional_inline}}</dt> - <dd><code>string</code>. Une URL à utiliser pour configurer le proxy.</dd> - <dt><code>autoLogin</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Ne pas demander l'authentification si le mot de passe est enregistré. Par défaut à <code>false</code>.</dd> - <dt><code>ftp</code>{{optional_inline}}</dt> - <dd><code>string</code>. L'adresse du proxy FTP. Peut inclure un port.</dd> - <dt><code>http</code>{{optional_inline}}</dt> - <dd><code>string</code>. L'adresse du proxy HTTP. Peut inclure un port.</dd> - <dt><code>httpProxyAll</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Utilisez le serveur proxy HTTP pour tous les protocoles. Par défaut à <code>false</code>.</dd> - <dt><code>passthrough</code>{{optional_inline}}</dt> - <dd><code>string</code>. Une liste d'hôtes séparés par des virgules qui ne doivent pas être mandatés. La valeur par défaut est "localhost, 127.0.0.1".</dd> - <dt><code>proxyDNS</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. DNS proxy lors de l'utilisation de SOCKS5. Par défaut à <code>false</code>.</dd> - <dt><code>proxyType</code>{{optional_inline}}</dt> - <dd><code>string</code>. Le type de proxy à utiliser. Cela peut prendre l'une des valeurs suivantes : "none", "autoDetect", "system", "manual", "autoConfig". Par défaut à "system".</dd> - <dt><code>socks</code>{{optional_inline}}</dt> - <dd><code>string</code>. L'adresse du proxy SOCKS. Peut inclure un port.</dd> - <dt><code>socksVersion</code>{{optional_inline}}</dt> - <dd><code>integer</code>. La version du proxy SOCKS. Peut être 4 ou 5. Par défaut à 5.</dd> - <dt><code>ssl</code>{{optional_inline}}</dt> - <dd><code>string</code>. L'adresse du proxy SSL. Peut inclure un port.</dd> -</dl> +- `autoConfigUrl`{{optional_inline}} + - : `string`. Une URL à utiliser pour configurer le proxy. +- `autoLogin`{{optional_inline}} + - : `boolean`. Ne pas demander l'authentification si le mot de passe est enregistré. Par défaut à `false`. +- `ftp`{{optional_inline}} + - : `string`. L'adresse du proxy FTP. Peut inclure un port. +- `http`{{optional_inline}} + - : `string`. L'adresse du proxy HTTP. Peut inclure un port. +- `httpProxyAll`{{optional_inline}} + - : `boolean`. Utilisez le serveur proxy HTTP pour tous les protocoles. Par défaut à `false`. +- `passthrough`{{optional_inline}} + - : `string`. Une liste d'hôtes séparés par des virgules qui ne doivent pas être mandatés. La valeur par défaut est "localhost, 127.0.0.1". +- `proxyDNS`{{optional_inline}} + - : `boolean`. DNS proxy lors de l'utilisation de SOCKS5. Par défaut à `false`. +- `proxyType`{{optional_inline}} + - : `string`. Le type de proxy à utiliser. Cela peut prendre l'une des valeurs suivantes : "none", "autoDetect", "system", "manual", "autoConfig". Par défaut à "system". +- `socks`{{optional_inline}} + - : `string`. L'adresse du proxy SOCKS. Peut inclure un port. +- `socksVersion`{{optional_inline}} + - : `integer`. La version du proxy SOCKS. Peut être 4 ou 5. Par défaut à 5. +- `ssl`{{optional_inline}} + - : `string`. L'adresse du proxy SSL. Peut inclure un port. -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">let proxySettings = { +```js +let proxySettings = { proxyType: "manual", http: "http://proxy.org:8080", socksVersion: 4, passthrough: ".example.org" }; -browser.proxy.settings.set({value: proxySettings});</pre> +browser.proxy.settings.set({value: proxySettings}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +## Compatibilité du navigateur -<p>{{Compat("webextensions.api.proxy.settings", 10)}}</p> +{{Compat("webextensions.api.proxy.settings", 10)}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/proxy/unregister/index.md b/files/fr/mozilla/add-ons/webextensions/api/proxy/unregister/index.md index 7331de1f79..8aab0c3b6f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/proxy/unregister/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/proxy/unregister/index.md @@ -12,42 +12,42 @@ tags: - unregister translation_of: Mozilla/Add-ons/WebExtensions/API/proxy/unregister --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}{{deprecated_header}} -<div>{{deprecated_header}}</div> +Cette méthode était obsolète dans Firefox 68 et sera supprimée de Firefox 71. Dans Firefox 68 ou une version ultérieure, l'appel de cette méthode enregistre un message d'erreur sur la console: -<p>Cette méthode était obsolète dans Firefox 68 et sera supprimée de Firefox 71. Dans Firefox 68 ou une version ultérieure, l'appel de cette méthode enregistre un message d'erreur sur la console:</p> + -<p><img alt="" src="proxy_unregister_warning.png"></p> +Annule l'inscription d'un [fichier Proxy Auto-Configuration (PAC)](/fr/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_%28PAC%29_file). Cela a été enregistré par un appel précédent à {{WebExtAPIRef("proxy.register()")}}. -<p>Annule l'inscription d'un <a href="/fr/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_%28PAC%29_file">fichier Proxy Auto-Configuration (PAC)</a>. Cela a été enregistré par un appel précédent à {{WebExtAPIRef("proxy.register()")}}.</p> +C'est une fonction asynchrome qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<p>C'est une fonction asynchrome qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +## Syntaxe -<h2 id="Syntaxe">Syntaxe</h2> +```js +var unregistering = browser.proxy.unregister() +``` -<pre class="brush: js">var unregistering = browser.proxy.unregister() -</pre> +### Paramètres -<h3 id="Paramètres">Paramètres</h3> +None. -<p>None.</p> +### Valeur retournée -<h3 id="Valeur_retournée">Valeur retournée</h3> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans arguments lorsque le fichier PAC a été désinscrit. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie sans arguments lorsque le fichier PAC a été désinscrit.</p> +## Exemples -<h2 id="Exemples">Exemples</h2> +```js +browser.proxy.unregister(); +``` -<pre class="brush: js">browser.proxy.unregister();</pre> +{{WebExtExamples}} -<p>{{WebExtExamples}}</p> +## Compatibilité du navigateur -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +{{Compat("webextensions.api.proxy.unregister")}} -<p>{{Compat("webextensions.api.proxy.unregister")}}</p> - -<div class="note"><p><strong>Note :</strong></p> - -<p>Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.</p> -</div> +> **Note :** +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. |