---
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>