chrome.dns

Descrição

Use a API chrome.dns para a resolução de DNS.

Permissões

dns

Disponibilidade

Canal de Desenvolvedor

Para usar essa API, declare a permissão "dns" no manifesto.

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

Observação:essa API só está disponível no Chrome Dev. Não há planos previstos para migrar essa API do canal de desenvolvimento para o Chrome Stable.

Uso

O código a seguir chama resolve() para recuperar o endereço 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();

Importante:não inclua o esquema ou a barra final no nome do host. Por exemplo, https://example.com/ é inválido.

Tipos

ResolveCallbackResolveInfo

Propriedades

• endereço

  string opcional

  Uma string que representa o literal do endereço IP. Fornecido somente se resultCode indicar sucesso.

• resultCode

  number

  O código do resultado. Zero indica sucesso.

Métodos

resolve()

Promessa

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

Resolve o nome do host ou literal de endereço IP fornecido.

Parâmetros

• nome do host

  string

  O nome do host a ser resolvido.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  (resolveInfo: ResolveCallbackResolveInfo) => void

  • resolveInfo

    ResolveCallbackResolveInfo

Retorna

• Promise<ResolveCallbackResolveInfo>

  O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.