dnsPromises.lookup()方法是dns模块的promises对象的内置应用程序编程接口,用于将给定参数的指定主机名的IP地址解析为第一个找到的A(IPv4)或AAAA(IPv6)记录。
用法:
dnsPromises.lookup( hostname, options )
参数:此方法具有上述和以下所述的两个参数:
- hostname:此参数指定一个字符串,该字符串表示要检查的主机名。
- options:它采用整数或对象的形式。它指定在查找期间要使用的选项。
- family:它是一个整数值,指定记录的族。其值必须为4、6或0,0表示同时返回IPv4和IPv6,4表示返回IPv4,6表示返回IPv6。默认值为0。
- hints:它是一个数字,指定一个或多个getaddrinfo标志。通过对其值进行按位或运算,可以传递多个标志。
- all:它是一个布尔参数。如果将其设置为TRUE,则回调将返回数组中所有已解析的地址,否则它将返回单个地址。其默认值为FALSE。
- verbatim:它是一个布尔参数。如果将其设置为TRUE,则回调将无顺序获得DNS解析程序返回的所有解析的IPv4和IPv6地址。如果设置为FALSE,则将IPv4地址放在IPv6地址之前。现在的默认值为FALSE,但预计不久后将为TRUE。
返回值:此方法返回错误,IP地址和IP地址系列。
以下示例说明了Node.js中dnsPromises.lookup()方法的使用:
范例1:
// Node.js program to demonstrate the
// dnsPromises.lookup() method
// Accessing promises object from dns module
const dns = require('dns');
const dnsPromises = dns.promises;
// Setting options for dnsPromises.lookup() method
const options = {
// Setting family as 6 i.e. IPv6
family:6,
hints:dns.ADDRCONFIG | dns.V4MAPPED,
};
// Calling dnsPromises.lookup() for hostname
// geeksforgeeks.org
dnsPromises.lookup('geeksforgeeks.org', options).then((response) => {
console.log(' family:IPv%s address:%j', response.family, response.address);
});
输出:
family:IPv6 address:"fd00:0:14:13::22da:3e74"
范例2:
// Node.js program to demonstrate the
// dnsPromises.lookup() method
// Accessing promises object from dns module
const dns = require('dns');
const dnsPromises = dns.promises;
// Setting options for dnsPromises.lookup()
// method, all as true
const options = {
all:true,
};
dnsPromises.lookup('geeksforgeeks.org', options).then((response) => {
console.log('addresses:%j', response);
});
输出:
addresses:[{"address":"34.218.62.116", "family":4}, {"address":"fd00:0:14:13::22da:3e74", "family":6}]
范例3:
// Node.js program to demonstrate the
// dnsPromises.lookup() method
// Accessing promises object from dns module
const dns = require('dns');
const dnsPromises = dns.promises;
// Setting options for dnsPromises.lookup()
// method, all as true
const options = {
all:true,
};
// Asynchronous function
(async function() {
// Address from lookup function
const addresses = await dnsPromises.lookup(
'geeksforgeeks.org', options);
// Printing addresses
console.log("from async:");
console.log(addresses);
})();
输出:
from async: [ { address:'34.218.62.116', family:4 }, { address:'fd00:0:14:13::22da:3e74', family:6 } ]
注意:上面的程序将通过使用node index.js
命令。
参考: https://nodejs.org/api/dns.html#dns_dnspromises_lookup_hostname_options
相关用法
注:本文由纯净天空筛选整理自anwesha0107大神的英文原创作品 Node.js | dnsPromises.lookup() Method。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。