blob: ecb976a87e661b185671b10dfff1fbda3853c779 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
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);
// > 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);
// > e.g. xyz.us-west-2.elb.amazonaws.com
// > 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>
|
