constructor

dns.Resolver.constructor

Not implemented in Bun

constructor Resolver(

options?: ResolverOptions

): Resolver;

Referenced types

interface ResolverOptions

maxTimeout?: number
The max retry timeout, in milliseconds.
timeout?: number
Query timeout in milliseconds, or -1 to use the default timeout.
tries?: number
The number of tries the resolver will try contacting each name server before giving up.

class Resolver

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 { Resolver } from 'node:dns';
const resolver = new 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', (err, addresses) => {
  // ...
});

The following methods from the node:dns module 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()

getServers: () => string[]
resolve: typeof resolve
resolve4: typeof resolve4
resolve6: typeof resolve6
resolveAny: typeof resolveAny
resolveCaa: typeof resolveCaa
resolveCname: typeof resolveCname
resolveMx: typeof resolveMx
resolveNaptr: typeof resolveNaptr
resolveNs: typeof resolveNs
resolvePtr: typeof resolvePtr
resolveSoa: typeof resolveSoa
resolveSrv: typeof resolveSrv
resolveTlsa: typeof resolveTlsa
resolveTxt: typeof resolveTxt
reverse: (ip: string, callback: (err: null | ErrnoException, hostnames: string[]) => void) => void
setServers: (servers: readonly string[]) => void
cancel(): void;
Cancel all outstanding DNS queries made by this resolver. The corresponding callbacks will be called with an error with code ECANCELLED.
setLocalAddress(
ipv4?: string,
ipv6?: string
): void;
The resolver instance will send its requests from the specified IP address. This allows programs to specify outbound interfaces when used on multi-homed systems.
If a v4 or v6 address is not specified, it is set to the default and the operating system will choose a local address automatically.
The resolver will use the v4 local address when making requests to IPv4 DNS servers, and the v6 local address when making requests to IPv6 DNS servers. The rrtype of resolution requests has no impact on the local address used.
@param ipv4
A string representation of an IPv4 address.
@param ipv6
A string representation of an IPv6 address.