chrome.dns

Descrição

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

Permissões

dns

Disponibilidade

Canal de Desenvolvedor

Para usar essa API, é necessário declarar 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 de transferir essa API do Canal de Desenvolvedor 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 de resultado. Zero indica sucesso.

Métodos

resolve()

Promessa

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

Resolve o nome do host ou o endereço IP literal informado.

Parâmetros

• nome do host

  string

  O nome do host a ser resolvido.

• callback

  função optional

  O parâmetro callback tem esta aparência:

  (resolveInfo: ResolveCallbackResolveInfo)=>void

  • resolveInfo

    ResolveCallbackResolveInfo

Retorna

• Promise<ResolveCallbackResolveInfo>

  Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.