Resolver

[<Interface>]
type Resolver =
    abstract member getServers: unit -> string array with get, set
    abstract member resolveAny: string -> Promise<AnyRecord array> with get, set
    abstract member resolveCaa: string -> Promise<CaaRecord array> with get, set
    abstract member resolveCname: string -> Promise<string array> with get, set
    abstract member resolveMx: string -> Promise<MxRecord array> with get, set
    abstract member resolveNaptr: string -> Promise<NaptrRecord array> with get, set
    abstract member resolveNs: string -> Promise<string array> with get, set
    abstract member resolvePtr: string -> Promise<string array> with get, set
    abstract member resolveSoa: string -> Promise<SoaRecord> with get, set
    abstract member resolveSrv: string -> Promise<SrvRecord array> with get, set
    abstract member resolveTlsa: string -> Promise<TlsaRecord array> with get, set
    abstract member resolveTxt: string -> Promise<string array array> with get, set
    abstract member reverse: string -> Promise<string array> with get, set
    abstract member setServers: string array -> unit with get, set
    abstract member cancel () : unit
    abstract member resolve (hostname: string, rrtype: string) : Promise<U9<string array,string array array,CaaRecord array,MxRecord array,NaptrRecord array,SrvRecord array,TlsaRecord array,AnyRecord array,SoaRecord>>
    abstract member resolve (hostname: string, rrtype: Rrtype) : Promise<string array>
    abstract member resolve (hostname: string) : Promise<string array>
    abstract member resolve4 (hostname: string, options: ResolveOptions) : Promise<U2<string array,RecordWithTtl array>>
    abstract member resolve4 (hostname: string, options: ResolveWithTtlOptions) : Promise<RecordWithTtl array>
    abstract member resolve4 (hostname: string) : Promise<string array>
    abstract member resolve6 (hostname: string, options: ResolveOptions) : Promise<U2<string array,RecordWithTtl array>>
    abstract member resolve6 (hostname: string, options: ResolveWithTtlOptions) : Promise<RecordWithTtl array>
    abstract member resolve6 (hostname: string) : Promise<string array>
    abstract member resolveANY (hostname: string) : Promise<AnyRecord array>
    abstract member resolveCAA (hostname: string) : Promise<CaaRecord array>
    abstract member resolveMX (hostname: string) : Promise<MxRecord array>
    abstract member resolveNAPTR (hostname: string) : Promise<NaptrRecord array>
    abstract member resolveSOA (hostname: string) : Promise<SoaRecord>
    abstract member resolveSRV (hostname: string) : Promise<SrvRecord array>
    abstract member resolveTLSA (hostname: string) : Promise<TlsaRecord array>
    abstract member resolveTXT (hostname: string) : Promise<string array array>
    abstract member setLocalAddress (?ipv4: string, ?ipv6: string) : unit

An independent resolver for DNS requests.

Creating a new resolver uses the default server settings. Setting the servers used for a resolver using resolver.setServers() does not affect other resolvers:

import { promises } from 'node:dns';
const resolver = new promises.Resolver();
resolver.setServers(['4.4.4.4']);

// This request will use the server at 4.4.4.4, independent of global settings.
resolver.resolve4('example.org').then((addresses) => {
// ...
});

// Alternatively, the same code can be written using async-await style.
(async function() {
const addresses = await resolver.resolve4('example.org');
})();

The following methods from the dnsPromises API are available:

• resolver.getServers()
• resolver.resolve()
• resolver.resolve4()
• resolver.resolve6()
• resolver.resolveAny()
• resolver.resolveCaa()
• resolver.resolveCname()
• resolver.resolveMx()
• resolver.resolveNaptr()
• resolver.resolveNs()
• resolver.resolvePtr()
• resolver.resolveSoa()
• resolver.resolveSrv()
• resolver.resolveTxt()
• resolver.reverse()
• resolver.setServers()

@since v10.6.0

Properties

abstract member getServers: unit -> string array with get, set

abstract member resolveAny: string -> Promise<AnyRecord array> with get, set

abstract member resolveCaa: string -> Promise<CaaRecord array> with get, set

abstract member resolveCname: string -> Promise<string array> with get, set

abstract member resolveMx: string -> Promise<MxRecord array> with get, set

abstract member resolveNaptr: string -> Promise<NaptrRecord array> with get, set

abstract member resolveNs: string -> Promise<string array> with get, set

abstract member resolvePtr: string -> Promise<string array> with get, set

abstract member resolveSoa: string -> Promise<SoaRecord> with get, set

abstract member resolveSrv: string -> Promise<SrvRecord array> with get, set

abstract member resolveTlsa: string -> Promise<TlsaRecord array> with get, set

abstract member resolveTxt: string -> Promise<string array array> with get, set

abstract member reverse: string -> Promise<string array> with get, set

abstract member setServers: string array -> unit with get, set

Methods

abstract member cancel () : unit

abstract member resolve (hostname: string, rrtype: string) : Promise<U9<string array,string array array,CaaRecord array,MxRecord array,NaptrRecord array,SrvRecord array,TlsaRecord array,AnyRecord array,SoaRecord>>

abstract member resolve (hostname: string, rrtype: Rrtype) : Promise<string array>

abstract member resolve (hostname: string) : Promise<string array>

abstract member resolve4 (hostname: string, options: ResolveOptions) : Promise<U2<string array,RecordWithTtl array>>

abstract member resolve4 (hostname: string, options: ResolveWithTtlOptions) : Promise<RecordWithTtl array>

abstract member resolve4 (hostname: string) : Promise<string array>

abstract member resolve6 (hostname: string, options: ResolveOptions) : Promise<U2<string array,RecordWithTtl array>>

abstract member resolve6 (hostname: string, options: ResolveWithTtlOptions) : Promise<RecordWithTtl array>

abstract member resolve6 (hostname: string) : Promise<string array>

abstract member resolveANY (hostname: string) : Promise<AnyRecord array>

function resolve(hostname: string, rrtype: "ANY"): Promise<AnyRecord[]>

abstract member resolveCAA (hostname: string) : Promise<CaaRecord array>

function resolve(hostname: string, rrtype: "CAA"): Promise<CaaRecord[]>

abstract member resolveMX (hostname: string) : Promise<MxRecord array>

function resolve(hostname: string, rrtype: "MX"): Promise<MxRecord[]>

abstract member resolveNAPTR (hostname: string) : Promise<NaptrRecord array>

function resolve(hostname: string, rrtype: "NAPTR"): Promise<NaptrRecord[]>

abstract member resolveSOA (hostname: string) : Promise<SoaRecord>

function resolve(hostname: string, rrtype: "SOA"): Promise<SoaRecord>

abstract member resolveSRV (hostname: string) : Promise<SrvRecord array>

function resolve(hostname: string, rrtype: "SRV"): Promise<SrvRecord[]>

abstract member resolveTLSA (hostname: string) : Promise<TlsaRecord array>

function resolve(hostname: string, rrtype: "TLSA"): Promise<TlsaRecord[]>

abstract member resolveTXT (hostname: string) : Promise<string array array>

function resolve(hostname: string, rrtype: "TXT"): Promise<string[][]>

abstract member setLocalAddress (?ipv4: string, ?ipv6: string) : unit