Résout le nom d'hôte donné en un enregistrement DNS.
C'est une fonction asynchrone qui renvoie une Promise
.
Syntaxe
var resolving = browser.dns.resolve(
hostname, // string
flags // array of string
)
Paramètres
hostname
. Le nom d'hôte à résoudre.string
flags
Facultatifarray
destring
. Drapeaux pour modifier la façon dont le nom d'hôte est résolu. Tous les indicateurs omis sont par défaut àfalse
. Vous pouvez passer zéro ou plusieurs des indicateurs suivants :-
"allow_name_collisions"
: autorise les résultats de collision de noms qui sont normalement filtrés."bypass_cache"
: Supprime le cache de recherche DNS interne."canonical_name"
: Le nom canonique de l'hôte spécifié sera interrogé."disable_ipv4"
: Seules les adresses IPv6 seront renvoyées."disable_ipv6"
: Seules les adresses IPv4 seront renvoyées."disable_trr"
: 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 DNS-over-HTTPS dédié."offline"
: seuls les littéraux et les entrées mises en cache seront renvoyés."priority_low"
: La priorité est donnée à la requête. Si "priority_medium" est également donné, la requête est prioritaire."priority_medium"
: La priorité est donnée à la requête. Si "priority_low" est également donné, la requête est prioritaire"speculate"
: 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.
Valeur retournée
A Promise
qui sera remplie avec un objet DNSRecord
object. Cet objet peut contenir les propriétés suivantes :
addresses
array
ofstring
. Les adresses IP associées à cet enregistrement DNS.canonicalName
string
. Le nom canonique de cet enregistrement. Ceci n'est inclus dans la réponse que si le drapeau"canonical_name"
a été passé àresolve()
.isTRR
boolean
:true
si l'enregistrement a été récupéré à l'aide d'un TRR (Trusted Recursive Resolver).
Exemples
function resolved(record) {
console.log(record.addresses);
}
let resolving = browser.dns.resolve("example.com");
resolving.then(resolved);
// > e.g. Array [ "73.284.240.12" ]
Contournez le cache et demandez le nom canonique:
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" ]
Compatibilité du navigateur
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.