chrome.dns

Description

Utilisez l'API chrome.dns pour la résolution DNS.

Autorisations

dns

Disponibilité

Chaîne de développement

Pour utiliser cette API, vous devez déclarer l'autorisation "dns" dans le manifest.

{
  "name": "My extension",
  ...
  "permissions": [
    "dns"
  ],
  ...
}

Remarque:Cette API n'est disponible que dans Chrome Dev. Il n'est pas prévu de la transférer de la version en développement vers la version stable de Chrome.

Utilisation

Le code suivant appelle resolve() pour récupérer l'adresse IP de example.com.

service-worker.js :

const resolveDNS = async () => {
    let record = await chrome.dns.resolve('example.com');
    console.log(record.address); // "192.0.2.172"
};

resolveDNS();

Important:N'incluez pas le schéma ni la barre oblique finale dans le nom d'hôte. Par exemple, https://example.com/ n'est pas valide.

Types

ResolveCallbackResolveInfo

Propriétés

• adresse

  chaîne facultatif

  Chaîne représentant le littéral d'adresse IP. Fourni uniquement si le code de résultat indique un succès.

• resultCode

  Nombre

  Code de résultat. Un zéro indique que la fonction a bien été exécutée.

Méthodes

resolve()

Promesse

chrome.dns.resolve(
  hostname: string,
  callback?: function,
)

Résout le nom d'hôte ou l'adresse IP littérale donnés.

Paramètres

• nom d'hôte

  chaîne

  Nom d'hôte à résoudre.

• rappel

  fonction facultatif

  Le paramètre callback se présente comme suit :

  (resolveInfo: ResolveCallbackResolveInfo) => void

  • resolveInfo

    ResolveCallbackResolveInfo

Renvoie

• Promise<ResolveCallbackResolveInfo>

  Les promesses sont compatibles avec la version 3 du fichier manifeste et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse se résout avec le même type que celui transmis au rappel.