Cette page a été traduite par l'API Cloud Translation.

chrome.dns

Description

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

Autorisations

dns

Disponibilité

<ph type="x-smartling-placeholder"></ph> Version en développement

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

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

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 resultCode indique une opération réussie.
resultCode

Nombre

Code de résultat. Le chiffre zéro indique une réussite.

Méthodes

resolve()

<ph type="x-smartling-placeholder"></ph> Promesse

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

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

Paramètres

nom d'hôte

chaîne

Nom d'hôte à résoudre.
rappel

function facultatif

Le paramètre callback se présente comme suit:
```
(resolveInfo: ResolveCallbackResolveInfo) => void
```
- resolveInfo
  
  ResolveCallbackResolveInfo

Renvoie

Promise<ResolveCallbackResolveInfo>

Les promesses sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La la promesse est résolue avec le même type que celui transmis au rappel.