chrome.dns

Opis

Do rozpoznawania nazw DNS użyj interfejsu API chrome.dns.

Uprawnienia

dns

Dostępność

Wersja deweloperska .

Aby używać tego interfejsu API, musisz zadeklarować uprawnienie "dns" w pliku manifestu.

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

Uwaga: ten interfejs API jest dostępny tylko w Chrome Dev. Nie przewidujemy przenoszenia tego interfejsu API z wersji deweloperskiej do stabilnej Chrome.

Wykorzystanie

Poniższy kod wywołuje metodę resolve(), aby uzyskać adres IP 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();

Ważne: w nazwie hosta nie umieszczaj schematu ani ukośnika końcowego. np. wartość https://example.com/ jest nieprawidłowa.

Typy

ResolveCallbackResolveInfo

Właściwości

• adres

  ciąg znaków opcjonalny

  Ciąg reprezentujący literał adresu IP. Wartość podawana tylko wtedy, gdy kod wyniku wskazuje na powodzenie.

• resultCode

  liczba

  Kod wyniku. Zero oznacza sukces.

Metody

resolve()

Obietnica .

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

Przekształca podany literał adresu IP lub nazwy hosta.

Parametry

• nazwa hosta

  ciąg znaków

  Nazwa hosta do rozpoznania.

• wywołanie zwrotne

  funkcja optional

  Parametr callback wygląda tak:

  (resolveInfo: ResolveCallbackResolveInfo) => void

  • resolveInfo

    ResolveCallbackResolveInfo

Zwroty

• Promise<ResolveCallbackResolveInfo>

  Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.