LogoPear Docs

bare-dns

Domain name resolution for JavaScript

stable

bare-dns — Domain name resolution for JavaScript. It is a native addon and requires Bare >=1.7.0.

Mirrors the Node.js dns module.

npm i bare-dns

Usage

const dns = require('bare-dns')

dns.lookup('github.com', (err, address, family) => {
  console.log(address, family)
})

API

dns

dns.IPFamily

type IPFamily = 4 | 6
Source

The IP address family: 4 for IPv4 or 6 for IPv6.

dns.lookup

dns.lookup(hostname: string, cb: (
      err: Error | null,
      address: string | null,
      family: IPFamily | 0
    ) => void): void
Source

Resolve hostname into an IP address using the operating system's getaddrinfo facility, not the DNS protocol directly. With all: true, the callback receives every resolved address instead of just the first.

Parameters

ParameterTypeDefaultDescription
hostnamestringThe host name to resolve.
cb( err: Error | null, address: string | null, family: IPFamily | 0 ) => voidCalled with (err, address, family), or (err, addresses) when all: true.

dns.resolveTxt(hostname: string, cb: (err: Error | null, records: string[][]) => void): void

Source

Use the DNS protocol to resolve TXT records for hostname. The callback receives an array of records, each itself an array of the strings that make up that record.

Parameters

ParameterTypeDefaultDescription
hostnamestringThe host name to query TXT records for.
cb(err: Error | null, records: string[][]) => voidCalled with (err, records); each record is an array of the strings it is made of.

DNSResolver

destroy(): void

Source

Cancel any pending queries on this resolver and release its underlying handle.

resolveTxt(hostname: string, cb: (err: Error | null, records: string[][]) => void): void

Source

Use the DNS protocol to resolve TXT records for hostname. The callback receives an array of records, each itself an array of the strings that make up that record.

Parameters

ParameterTypeDefaultDescription
hostnamestringThe host name to query TXT records for.
cb(err: Error | null, records: string[][]) => voidCalled with (err, records); each record is an array of the strings it is made of.

Types

LookupOptions

interface LookupOptions {
  family?: `IPv${IPFamily}` | IPFamily | 0
  hints?: number
  all?: boolean
}
Source

See also

On this page