Node dns.promises.Resolver class | API Reference | Bun

Node dns.promises.Resolver class | API Reference | Bun { // ... }); // 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()`"/> { // ... }); // 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()`"/>BuildDocsReferenceGuidesBlogDiscord/node:dns/promises/ResolverMcancelCoconstructorPgetServersPresolvePresolve4Presolve6PresolveAnyPresolveCaaPresolveCnamePresolveMxPresolveNaptrPresolveNsPresolvePtrPresolveSoaPresolveSrvPresolveTlsaPresolveTxtPreverseMsetLocalAddressPsetServers

Search the reference...

/

BuildDocsReferenceGuidesBlogDiscord/node:dns/promises/ResolverMcancelCoconstructorPgetServersPresolvePresolve4Presolve6PresolveAnyPresolveCaaPresolveCnamePresolveMxPresolveNaptrPresolveNsPresolvePtrPresolveSoaPresolveSrvPresolveTlsaPresolveTxtPreverseMsetLocalAddressPsetServers

class

dns.promises.Resolver { // ... }); // 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()`" data-algolia-static="false" data-algolia-merged="false" data-type="Class">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 { 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()

getServers: () => string[]resolve: {(hostname: string) => Promisestring[]>; (hostname: string, rrtype: 'A' | 'AAAA' | 'CNAME' | 'NS' | 'PTR') => Promisestring[]>; (hostname: string, rrtype: 'ANY') => PromiseAnyRecord[]>; (hostname: string, rrtype: 'CAA') => PromiseCaaRecord[]>; (hostname: string, rrtype: 'MX') => PromiseMxRecord[]>; (hostname: string, rrtype: 'NAPTR') => PromiseNaptrRecord[]>; (hostname: string, rrtype: 'SOA') => PromiseSoaRecord>; (hostname: string, rrtype: 'SRV') => PromiseSrvRecord[]>; (hostname: string, rrtype: 'TLSA') => PromiseTlsaRecord[]>; (hostname: string, rrtype: 'TXT') => Promisestring[][]>; (hostname: string, rrtype: string) => Promisestring[] | SoaRecord | AnyRecord[] | CaaRecord[] | MxRecord[] | NaptrRecord[] | SrvRecord[] | TlsaRecord[] | string[][]>}resolve4: {(hostname: string) => Promisestring[]>; (hostname: string, options: ResolveWithTtlOptions) => PromiseRecordWithTtl[]>; (hostname: string, options: ResolveOptions) => Promisestring[] | RecordWithTtl[]>}resolve6: {(hostname: string) => Promisestring[]>; (hostname: string, options: ResolveWithTtlOptions) => PromiseRecordWithTtl[]>; (hostname: string, options: ResolveOptions) => Promisestring[] | RecordWithTtl[]>}resolveAny: (hostname: string) => PromiseAnyRecord[]>resolveCaa: (hostname: string) => PromiseCaaRecord[]>resolveCname: (hostname: string) => Promisestring[]>resolveMx: (hostname: string) => PromiseMxRecord[]>resolveNaptr: (hostname: string) => PromiseNaptrRecord[]>resolveNs: (hostname: string) => Promisestring[]>resolvePtr: (hostname: string) => Promisestring[]>resolveSoa: (hostname: string) => PromiseSoaRecord>resolveSrv: (hostname: string) => PromiseSrvRecord[]>resolveTlsa: (hostname: string) => PromiseTlsaRecord[]>resolveTxt: (hostname: string) => Promisestring[][]>reverse: (ip: string) => Promisestring[]>setServers: (servers: readonly string[]) => voidcancel(): 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.

Resources

ReferenceDocsGuidesDiscordMerch StoreGitHubBlog 

Toolkit

RuntimePackage managerTest runnerBundlerPackage runner

Project

Bun 1.0Bun 1.1Bun 1.2Bun 1.3RoadmapContributingLicense

Baked with ❤️ in San Francisco

We're hiring →