deno / 1.23.2 / ~ / deno.resolvedns.html /

Deno.resolveDns

Performs DNS resolution against the given query, returning resolved records. Fails in the cases such as:

  • the query is in invalid format
  • the options have an invalid parameter, e.g. nameServer.port is beyond the range of 16-bit unsigned integer
  • timed out
const a = await Deno.resolveDns("example.com", "A");

const aaaa = await Deno.resolveDns("example.com", "AAAA", {
  nameServer: { ipAddr: "8.8.8.8", port: 53 },
});

Requires allow-net permission.

function resolveDns(
query: string,
recordType:
| "A"
| "AAAA"
| "ANAME"
| "CNAME"
| "NS"
| "PTR"
,
options?: ResolveDnsOptions,
) : Promise<string[]>;
function resolveDns(
query: string,
recordType: "CAA",
options?: ResolveDnsOptions,
) : Promise<CAARecord[]>;
function resolveDns(
query: string,
recordType: "MX",
options?: ResolveDnsOptions,
) : Promise<MXRecord[]>;
function resolveDns(
query: string,
recordType: "NAPTR",
options?: ResolveDnsOptions,
) : Promise<NAPTRRecord[]>;
function resolveDns(
query: string,
recordType: "SOA",
options?: ResolveDnsOptions,
) : Promise<SOARecord[]>;
function resolveDns(
query: string,
recordType: "SRV",
options?: ResolveDnsOptions,
) : Promise<SRVRecord[]>;
function resolveDns(
query: string,
recordType: "TXT",
options?: ResolveDnsOptions,
) : Promise<string[][]>;
function resolveDns(
query: string,
recordType: RecordType,
options?: ResolveDnsOptions,
) : Promise<string[] | CAARecord[] | MXRecord[] | NAPTRRecord[] | SOARecord[] | SRVRecord[] | string[][]>;
resolveDns( query: string , recordType: "A" | "AAAA" | "ANAME" | "CNAME" | "NS" | "PTR" , options?: ResolveDnsOptions) : Promise<string[]>

Parameters

query: string
recordType: "A" | "AAAA" | "ANAME" | "CNAME" | "NS" | "PTR"
options?: ResolveDnsOptions optional

Return Type

Promise<string[]>
resolveDns( query: string , recordType: "CAA" , options?: ResolveDnsOptions) : Promise<CAARecord[]>

Parameters

query: string
recordType: "CAA"
options?: ResolveDnsOptions optional

Return Type

Promise<CAARecord[]>
resolveDns( query: string , recordType: "MX" , options?: ResolveDnsOptions) : Promise<MXRecord[]>

Parameters

query: string
recordType: "MX"
options?: ResolveDnsOptions optional

Return Type

Promise<MXRecord[]>
resolveDns( query: string , recordType: "NAPTR" , options?: ResolveDnsOptions) : Promise<NAPTRRecord[]>

Parameters

query: string
recordType: "NAPTR"
options?: ResolveDnsOptions optional

Return Type

Promise<NAPTRRecord[]>
resolveDns( query: string , recordType: "SOA" , options?: ResolveDnsOptions) : Promise<SOARecord[]>

Parameters

query: string
recordType: "SOA"
options?: ResolveDnsOptions optional

Return Type

Promise<SOARecord[]>
resolveDns( query: string , recordType: "SRV" , options?: ResolveDnsOptions) : Promise<SRVRecord[]>

Parameters

query: string
recordType: "SRV"
options?: ResolveDnsOptions optional

Return Type

Promise<SRVRecord[]>
resolveDns( query: string , recordType: "TXT" , options?: ResolveDnsOptions) : Promise<string[][]>

Parameters

query: string
recordType: "TXT"
options?: ResolveDnsOptions optional

Return Type

Promise<string[][]>
resolveDns( query: string , recordType: RecordType , options?: ResolveDnsOptions) : Promise<string[] | CAARecord[] | MXRecord[] | NAPTRRecord[] | SOARecord[] | SRVRecord[] | string[][]>

Performs DNS resolution against the given query, returning resolved records. Fails in the cases such as:

  • the query is in invalid format
  • the options have an invalid parameter, e.g. nameServer.port is beyond the range of 16-bit unsigned integer
  • timed out
const a = await Deno.resolveDns("example.com", "A");

const aaaa = await Deno.resolveDns("example.com", "AAAA", {
  nameServer: { ipAddr: "8.8.8.8", port: 53 },
});

Requires allow-net permission.

Parameters

query: string
recordType: RecordType
options?: ResolveDnsOptions optional

Return Type

Promise<string[] | CAARecord[] | MXRecord[] | NAPTRRecord[] | SOARecord[] | SRVRecord[] | string[][]>

© 2018–2022 the Deno authors
https://doc.deno.land/deno/stable/~/Deno.resolveDns

Name Deno
Version
Badge
Last Updated 2022-07-04T20:53:35Z