当前位置: 首页>>代码示例 >>用法及示例精选 >>正文


Node.js dnsPromises.lookup()用法及代码示例


dnsPromises.lookup()方法是dns模块的promises对象的内置应用程序编程接口,用于将给定参数的指定主机名的IP地址解析为第一个找到的A(IPv4)或AAAA(IPv6)记录。

用法:

dnsPromises.lookup( hostname, options )

参数:此方法具有上述和以下所述的两个参数:


  1. hostname:此参数指定一个字符串,该字符串表示要检查的主机名。
  2. 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。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。