Node.js dns.resolveSoa() Method

The dns.resolveSoa() method is an inbuilt application programming interface of the dns module which is used to resolve SOA or start of authority records for the specified hostname using DNS protocol.

Syntax:

dns.resolveSoa( hostname, callback )

Parameters: This method has two parameters as mentioned above and described below:

• hostname: This parameter specifies a string which denotes the hostname to be resolved.
• callback: It specifies a function to be called after DNS resolution of the hostnames.
  • error: It specifies error if generated.
  • addresses: It is an array of string that signifies the returned a start of authority(SOA) records for the hostname.

Return Value: This method returns error, addresses through callback function. These data are passed as parameters to the callback function. The address parameter will contain nsname, hostmaster, serial, refresh, retry, expire and minttl properties.

Below examples illustrate the use of dns.resolveSoa() method in Node.js:

Example 1:

// Node.js program to demonstrate the
// dns.resolveSoa() method

// Accessing dns module
const dns = require('dns');

// Calling dns.resolveSoa() method for hostname
//  geeksforgeeks.org and displaying them in
// console as a callback
dns.resolveSoa('geeksforgeeks.org', (err,
    addresses) => console.log('SOA records: %j', addresses));

Output:

SOA records: {
    "nsname":"ns-869.awsdns-44.net",
    "hostmaster":"awsdns-hostmaster.amazon.com",
    "serial":1,
    "refresh":7200,
    "retry":900,
    "expire":1209600,
    "minttl":86400
}

Example 2:

// Node.js program to demonstrate the
// dns.resolveSoa() method

// Accessing dns module
const dns = require('dns');

// Calling dns.resolveSoa() method for hostname
// google.com printing them in console as a callback
dns.resolveSoa('google.com', (err,
    addresses) => console.log('SOA records: %j', addresses));

Output:

SOA records: {
    "nsname":"ns1.google.com",
    "hostmaster":"dns-admin.google.com",
    "serial":287530106,
    "refresh":900,
    "retry":900,
    "expire":1800,
    "minttl":60
}

Note: The above program will compile and run by using the node index.js command.

Reference: https://nodejs.org/api/dns.html#dns_dns_resolvesoa_hostname_callback