Function signature
function getAllDnsRecords(
domain: string,
options?: GetAllDnsRecordsOptions
): Promise<DnsRecord[]>
- Queries multiple record types (NS, SOA, A, AAAA, MX, TXT)
- Checks common subdomains from a built-in list
- Discovers subdomains from DNS records (MX, CNAME, SPF in TXT)
- Detects and groups wildcard records
Parameters
Valid domain name, without subdomain or protocol. For example: example.com, not https://www.example.com
Options for DNS resolver, extra subdomains to check, etc.Which DNS resolver to use for DNS lookup. Options:
cloudflare-dnsgoogle-dnsnode-dnsnode-digdeno-dns
If not specified, the best resolver for the current runtime is selected automatically. options.commonSubdomainsCheck
Check for common subdomains from the built-in list. Enabled by default.
List of extra subdomains to check for beyond the built-in common subdomains list.
Returns
A promise that resolves to an array of all DnsRecord objects discovered for the domain, with wildcard records detected and grouped.Each DnsRecord contains:
name (string): Fully qualified domain nametype (DnsRecordType): Record typettl (number): Time to live in secondsdata (string): Record data
Examples
Get all DNS records with default options
import { getAllDnsRecords } from '@layered/dns-records'
const records = await getAllDnsRecords('example.com')
// Returns all discovered DNS records with automatic resolver selection
Get all DNS records from Cloudflare DNS resolver
import { getAllDnsRecords } from '@layered/dns-records'
const records = await getAllDnsRecords('example.com', {
resolver: 'cloudflare-dns',
})
Get all DNS records with custom subdomains
import { getAllDnsRecords } from '@layered/dns-records'
const records = await getAllDnsRecords('example.com', {
subdomains: ['api', 'staging', 'dev'],
commonSubdomainsCheck: true,
})
// Checks custom subdomains plus the built-in common subdomains list
Disable common subdomains check
import { getAllDnsRecords } from '@layered/dns-records'
const records = await getAllDnsRecords('example.com', {
commonSubdomainsCheck: false,
})
// Only checks the base domain, no subdomain enumeration
