Resolver

external class Resolver(source)

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

Constructors

Link copied to clipboard
constructor(options: ResolverOptions = definedExternally)

Properties

Link copied to clipboard
var getServers: () -> ERROR CLASS: Symbol not found for js.array.ReadonlyArray<kotlin/String>
Link copied to clipboard
var setServers: (@R|kotlin/ParameterName|(name = String(servers)) ERROR CLASS: Symbol not found for js.array.ReadonlyArray<kotlin/String>) -> Unit

Functions

Link copied to clipboard
fun cancel()

Cancel all outstanding DNS queries made by this resolver. The corresponding callbacks will be called with an error with code ECANCELLED.

Link copied to clipboard
suspend fun resolve(hostname: String): ERROR CLASS: Symbol not found for js.array.ReadonlyArray<kotlin/String>
suspend fun resolve(hostname: String, rrtype: String): Any
suspend fun resolve(hostname: String, rrtype: ResourceRecordType.ANY): ERROR CLASS: Symbol not found for js.array.ReadonlyArray<{node/dns/AnyRecord=} kotlin/Any>
suspend fun resolve(hostname: String, rrtype: ResourceRecordType.CAA): ERROR CLASS: Symbol not found for js.array.ReadonlyArray<node/dns/CaaRecord>
suspend fun resolve(hostname: String, rrtype: ResourceRecordType.MX): ERROR CLASS: Symbol not found for js.array.ReadonlyArray<node/dns/MxRecord>
suspend fun resolve(hostname: String, rrtype: ResourceRecordType.NAPTR): ERROR CLASS: Symbol not found for js.array.ReadonlyArray<node/dns/NaptrRecord>
suspend fun resolve(hostname: String, rrtype: ResourceRecordType.SOA): SoaRecord
suspend fun resolve(hostname: String, rrtype: ResourceRecordType.SRV): ERROR CLASS: Symbol not found for js.array.ReadonlyArray<node/dns/SrvRecord>
suspend fun resolve(hostname: String, rrtype: ResourceRecordType.StringRecord): ERROR CLASS: Symbol not found for js.array.ReadonlyArray<kotlin/String>
suspend fun resolve(hostname: String, rrtype: ResourceRecordType.TLSA): ERROR CLASS: Symbol not found for js.array.ReadonlyArray<node/dns/TlsaRecord>
suspend fun resolve(hostname: String, rrtype: ResourceRecordType.TXT): ERROR CLASS: Symbol not found for js.array.ReadonlyArray<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<kotlin/String>>
Link copied to clipboard
suspend fun resolve4(hostname: String): ERROR CLASS: Symbol not found for js.array.ReadonlyArray<kotlin/String>
suspend fun resolve4(hostname: String, options: ResolveOptions): Any
suspend fun resolve4(hostname: String, options: ResolveWithTtlOptions): ERROR CLASS: Symbol not found for js.array.ReadonlyArray<node/dns/RecordWithTtl>
Link copied to clipboard
fun resolve4Async(hostname: String): ERROR CLASS: Symbol not found for Promise<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<kotlin/String>>
fun resolve4Async(hostname: String, options: ResolveOptions): ERROR CLASS: Symbol not found for Promise<kotlin/Any>
fun resolve4Async(hostname: String, options: ResolveWithTtlOptions): ERROR CLASS: Symbol not found for Promise<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<node/dns/RecordWithTtl>>
Link copied to clipboard
suspend fun resolve6(hostname: String): ERROR CLASS: Symbol not found for js.array.ReadonlyArray<kotlin/String>
suspend fun resolve6(hostname: String, options: ResolveOptions): Any
suspend fun resolve6(hostname: String, options: ResolveWithTtlOptions): ERROR CLASS: Symbol not found for js.array.ReadonlyArray<node/dns/RecordWithTtl>
Link copied to clipboard
fun resolve6Async(hostname: String): ERROR CLASS: Symbol not found for Promise<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<kotlin/String>>
fun resolve6Async(hostname: String, options: ResolveOptions): ERROR CLASS: Symbol not found for Promise<kotlin/Any>
fun resolve6Async(hostname: String, options: ResolveWithTtlOptions): ERROR CLASS: Symbol not found for Promise<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<node/dns/RecordWithTtl>>
Link copied to clipboard
suspend fun resolveAny(hostname: String): ERROR CLASS: Symbol not found for js.array.ReadonlyArray<{node/dns/AnyRecord=} kotlin/Any>
Link copied to clipboard
fun resolveAnyAsync(hostname: String): ERROR CLASS: Symbol not found for Promise<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<{node/dns/AnyRecord=} kotlin/Any>>
Link copied to clipboard
fun resolveAsync(hostname: String): ERROR CLASS: Symbol not found for Promise<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<kotlin/String>>
fun resolveAsync(hostname: String, rrtype: String): ERROR CLASS: Symbol not found for Promise<kotlin/Any>
fun resolveAsync(hostname: String, rrtype: ResourceRecordType.ANY): ERROR CLASS: Symbol not found for Promise<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<{node/dns/AnyRecord=} kotlin/Any>>
fun resolveAsync(hostname: String, rrtype: ResourceRecordType.CAA): ERROR CLASS: Symbol not found for Promise<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<node/dns/CaaRecord>>
fun resolveAsync(hostname: String, rrtype: ResourceRecordType.MX): ERROR CLASS: Symbol not found for Promise<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<node/dns/MxRecord>>
fun resolveAsync(hostname: String, rrtype: ResourceRecordType.NAPTR): ERROR CLASS: Symbol not found for Promise<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<node/dns/NaptrRecord>>
fun resolveAsync(hostname: String, rrtype: ResourceRecordType.SOA): ERROR CLASS: Symbol not found for Promise<node/dns/SoaRecord>
fun resolveAsync(hostname: String, rrtype: ResourceRecordType.SRV): ERROR CLASS: Symbol not found for Promise<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<node/dns/SrvRecord>>
fun resolveAsync(hostname: String, rrtype: ResourceRecordType.StringRecord): ERROR CLASS: Symbol not found for Promise<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<kotlin/String>>
fun resolveAsync(hostname: String, rrtype: ResourceRecordType.TLSA): ERROR CLASS: Symbol not found for Promise<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<node/dns/TlsaRecord>>
fun resolveAsync(hostname: String, rrtype: ResourceRecordType.TXT): ERROR CLASS: Symbol not found for Promise<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<kotlin/String>>>
Link copied to clipboard
suspend fun resolveCaa(hostname: String): ERROR CLASS: Symbol not found for js.array.ReadonlyArray<node/dns/CaaRecord>
Link copied to clipboard
fun resolveCaaAsync(hostname: String): ERROR CLASS: Symbol not found for Promise<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<node/dns/CaaRecord>>
Link copied to clipboard
suspend fun resolveCname(hostname: String): ERROR CLASS: Symbol not found for js.array.ReadonlyArray<kotlin/String>
Link copied to clipboard
fun resolveCnameAsync(hostname: String): ERROR CLASS: Symbol not found for Promise<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<kotlin/String>>
Link copied to clipboard
suspend fun resolveMx(hostname: String): ERROR CLASS: Symbol not found for js.array.ReadonlyArray<node/dns/MxRecord>
Link copied to clipboard
fun resolveMxAsync(hostname: String): ERROR CLASS: Symbol not found for Promise<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<node/dns/MxRecord>>
Link copied to clipboard
suspend fun resolveNaptr(hostname: String): ERROR CLASS: Symbol not found for js.array.ReadonlyArray<node/dns/NaptrRecord>
Link copied to clipboard
fun resolveNaptrAsync(hostname: String): ERROR CLASS: Symbol not found for Promise<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<node/dns/NaptrRecord>>
Link copied to clipboard
suspend fun resolveNs(hostname: String): ERROR CLASS: Symbol not found for js.array.ReadonlyArray<kotlin/String>
Link copied to clipboard
fun resolveNsAsync(hostname: String): ERROR CLASS: Symbol not found for Promise<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<kotlin/String>>
Link copied to clipboard
suspend fun resolvePtr(hostname: String): ERROR CLASS: Symbol not found for js.array.ReadonlyArray<kotlin/String>
Link copied to clipboard
fun resolvePtrAsync(hostname: String): ERROR CLASS: Symbol not found for Promise<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<kotlin/String>>
Link copied to clipboard
suspend fun resolveSoa(hostname: String): SoaRecord
Link copied to clipboard
fun resolveSoaAsync(hostname: String): ERROR CLASS: Symbol not found for Promise<node/dns/SoaRecord>
Link copied to clipboard
suspend fun resolveSrv(hostname: String): ERROR CLASS: Symbol not found for js.array.ReadonlyArray<node/dns/SrvRecord>
Link copied to clipboard
fun resolveSrvAsync(hostname: String): ERROR CLASS: Symbol not found for Promise<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<node/dns/SrvRecord>>
Link copied to clipboard
suspend fun resolveTlsa(hostname: String): ERROR CLASS: Symbol not found for js.array.ReadonlyArray<node/dns/TlsaRecord>
Link copied to clipboard
fun resolveTlsaAsync(hostname: String): ERROR CLASS: Symbol not found for Promise<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<node/dns/TlsaRecord>>
Link copied to clipboard
suspend fun resolveTxt(hostname: String): ERROR CLASS: Symbol not found for js.array.ReadonlyArray<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<kotlin/String>>
Link copied to clipboard
fun resolveTxtAsync(hostname: String): ERROR CLASS: Symbol not found for Promise<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<kotlin/String>>>
Link copied to clipboard
suspend fun reverse(ip: String): ERROR CLASS: Symbol not found for js.array.ReadonlyArray<kotlin/String>
Link copied to clipboard
fun reverseAsync(ip: String): ERROR CLASS: Symbol not found for Promise<ERROR CLASS: Symbol not found for js.array.ReadonlyArray<kotlin/String>>
Link copied to clipboard
fun setLocalAddress(ipv4: String = definedExternally, ipv6: String = definedExternally)

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.