initial commit

2 files changed, 133 insertions, 0 deletions

diff --git a/files/fr/mozilla/add-ons/webextensions/api/dns/index.html b/files/fr/mozilla/add-ons/webextensions/api/dns/index.html
new file mode 100644
index 0000000000..aaac9b867d
--- /dev/null
+++ b/files/fr/mozilla/add-ons/webextensions/api/dns/index.html
@@ -0,0 +1,31 @@
+---
+title: dns
+slug: Mozilla/Add-ons/WebExtensions/API/dns
+tags:
+  - API
+  - Add-ons
+  - DNS
+  - Extensions
+  - WebExtensions
+translation_of: Mozilla/Add-ons/WebExtensions/API/dns
+---
+<div>{{AddonSidebar}}</div>
+
+<div>Active une extension pour résoudre les noms de domaine.</div>
+
+<div></div>
+
+<div>Pour utiliser cette API, une extension doit demander la permission "dns" <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> dans son fichier <code><a href="/fr/Add-ons/WebExtensions/manifest.json">manifest.json</a></code> .</div>
+
+<h2 id="Fonctions">Fonctions</h2>
+
+<dl>
+ <dt>{{WebExtAPIRef("dns.resolve()")}}</dt>
+ <dd>Résout le nom d'hôte donné en un enregistrement DNS</dd>
+</dl>
+
+<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2>
+
+<p>{{Compat("webextensions.api.dns")}}</p>
+
+<p>{{WebExtExamples("h2")}}</p>
diff --git a/files/fr/mozilla/add-ons/webextensions/api/dns/resolve/index.html b/files/fr/mozilla/add-ons/webextensions/api/dns/resolve/index.html
new file mode 100644
index 0000000000..ecb976a87e
--- /dev/null
+++ b/files/fr/mozilla/add-ons/webextensions/api/dns/resolve/index.html
@@ -0,0 +1,102 @@
+---
+title: dns.resolve()
+slug: Mozilla/Add-ons/WebExtensions/API/dns/resolve
+tags:
+  - API
+  - Add-ons
+  - DNS
+  - Extensions
+  - Method
+  - Reference
+  - WebExtensions
+  - resolve
+translation_of: Mozilla/Add-ons/WebExtensions/API/dns/resolve
+---
+<div>{{AddonSidebar()}}</div>
+
+<p>Résout le nom d'hôte donné en un enregistrement DNS.</p>
+
+<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p>
+
+<h2 id="Syntaxe">Syntaxe</h2>
+
+<pre class="syntaxbox brush:js">var resolving = browser.dns.resolve(
+  hostname,    // string
+  flags        // array of string
+)
+</pre>
+
+<h3 id="Paramètres">Paramètres</h3>
+
+<dl>
+ <dt><code>hostname</code></dt>
+ <dd><code><code>string</code></code>. Le nom d'hôte à résoudre.</dd>
+ <dt><code>flags</code> {{optional_inline}}</dt>
+ <dd><code>array</code> de <code>string</code>. Drapeaux pour modifier la façon dont le nom d'hôte est résolu. Tous les indicateurs omis sont par défaut à <code>false</code>. Vous pouvez passer zéro ou plusieurs des indicateurs suivants :</dd>
+ <dd>
+ <ul>
+  <li><code>"allow_name_collisions"</code>: autorise les résultats de collision de noms qui sont normalement filtrés.</li>
+  <li><code>"bypass_cache"</code>: Supprime le cache de recherche DNS interne.</li>
+  <li><code>"canonical_name"</code>: Le nom canonique de l'hôte spécifié sera interrogé.</li>
+  <li><code>"disable_ipv4"</code>: Seules les adresses IPv6 seront renvoyées.</li>
+  <li><code>"disable_ipv6"</code>: Seules les adresses IPv4 seront renvoyées.</li>
+  <li><code>"disable_trr"</code>: n'utilisez pas le TRR (Trusted Recursive Resolver) pour résoudre le nom d'hôte. Un TRR permet la résolution des noms d'hôtes à l'aide d'un serveur <a href="https://tools.ietf.org/html/draft-ietf-doh-dns-over-https-02">DNS-over-HTTPS</a> dédié.</li>
+  <li><code>"offline"</code>: seuls les littéraux et les entrées mises en cache seront renvoyés.</li>
+  <li><code>"priority_low"</code>: La priorité est donnée à la requête. Si "priority_medium" est également donné, la requête est prioritaire.</li>
+  <li><code>"priority_medium"</code>: La priorité est donnée à la requête. Si "priority_low" est également donné, la requête est prioritaire</li>
+  <li><code>"speculate"</code>: Indique que la requête est spéculative. Les demandes spéculatives renvoient des erreurs si la prélecture est désactivée par la configuration du navigateur.</li>
+ </ul>
+ </dd>
+</dl>
+
+<h3 id="Valeur_retournée">Valeur retournée</h3>
+
+<p>A <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promisee">Promise</a></code> qui sera remplie avec un objet <code>DNSRecord</code> object. Cet objet peut contenir les propriétés suivantes :</p>
+
+<dl>
+ <dt><code>addresses</code></dt>
+ <dd><code>array</code> of <code>string</code>. Les adresses IP associées à cet enregistrement DNS.</dd>
+ <dt><code>canonicalName</code></dt>
+ <dd><code>string</code>. Le nom canonique de cet enregistrement. Ceci n'est inclus dans la réponse que si le drapeau <code>"canonical_name"</code>a été passé à  <code>resolve()</code>.</dd>
+ <dt><code>isTRR</code></dt>
+ <dd><code>boolean</code>: <code>true</code> si l'enregistrement a été récupéré à l'aide d'un TRR (Trusted Recursive Resolver).</dd>
+</dl>
+
+<h2 id="Exemples">Exemples</h2>
+
+<pre class="brush: js">function resolved(record) {
+  console.log(record.addresses);
+}
+
+let resolving = browser.dns.resolve("example.com");
+resolving.then(resolved);
+
+// &gt; e.g. Array [ "73.284.240.12" ]
+</pre>
+
+<p>Contournez le cache et demandez le nom canonique:</p>
+
+<pre class="brush: js">function resolved(record) {
+  console.log(record.canonicalName);
+  console.log(record.addresses);
+}
+
+let resolving = browser.dns.resolve("developer.mozilla.org",
+                                   ["bypass_cache", "canonical_name"]);
+resolving.then(resolved);
+
+// &gt; e.g. xyz.us-west-2.elb.amazonaws.com
+// &gt; e.g. Array [ "78.18.187.134", "34.79.135.234" ]</pre>
+
+<p>{{WebExtExamples}}</p>
+
+
+
+<dl>
+</dl>
+
+<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2>
+
+<p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p>
+
+<p>{{Compat("webextensions.api.dns.resolve")}}</p>