Node.js v0.10.31API手册-DNS

2021-11-04 14:48:12

原API变化，故译文与之前译文样式上有所不同

Node.js v0.10.31API手册-目录

DNS

使用 require(‘dns‘) 引入此模块。dns 模块中的所有方法都使用了 C-Ares，除了 dns.lookup 使用了线程池中的 getaddrinfo(3)。C-Ares 比 getaddrinfo 要快得多，但系统解析器相对于其它程序的操作要更固定。当一个用户使用

net.connect(80,
 ‘google.com‘)

或

http.get({
 host: ‘google.com‘ })

时会使用 dns.lookup方法。如果用户需要进行大量的快速查询，则最好使用 C-Ares 提供的方法。

下面是一个解析 ‘www.google.com‘ 并反向解析所返回 IP 地址的例子。

var dns = require(‘dns‘);

dns.resolve4(‘www.google.com‘, function (err, addresses) {
  if (err) throw err;

  console.log(‘addresses: ‘ + JSON.stringify(addresses));

  addresses.forEach(function (a) {
    dns.reverse(a, function (err, domains) {
      if (err) {
        throw err;
      }

      console.log(‘reverse for ‘ + a + ‘: ‘ + JSON.stringify(domains));
    });
  });
});

dns.lookup(domain, [family], callback)

将一个域名（比如 ‘google.com‘）解析为第一个找到的 A 记录（IPv4）或 AAAA 记录（IPv6）。地址族family 可以是数字 4 或 6，缺省为 null 表示同时允许 IPv4 和 IPv6 地址族。

回调参数为

(err,
 address, family)

。地址 address 参数为一个代表 IPv4 或 IPv6 地址的字符串。地址族family 参数为数字 4 或 6，地表 address 的地址族（不一定是之前传入 lookup 的值）。

当错误发生时，err 为一个 Error 对象，其中 err.code 为错误代码。请记住 err.code 被设定为 ‘ENOENT‘的情况不仅是域名不存在，也可能是查询在其它途径出错，比如没有可用文件描述符时。

dns.resolve(domain, [rrtype], callback)

将一个域名（比如 ‘google.com‘）解析为一个 rrtype 指定记录类型的数组。有效 rrtypes 取值有‘A‘（IPv4 地址，缺省）、‘AAAA‘（IPv6 地址）、‘MX‘（邮件交换记录）、‘TXT‘（文本记录）、‘SRV‘（SRV 记录）、‘PTR‘（用于 IP 反向查找）、‘NS‘（域名服务器记录）和 ‘CNAME‘（别名记录）。

回调参数为

(err,
 addresses)

。其中 addresses 中每一项的类型取决于记录类型，详见下文对应的查找方法。

当出错时，err 参数为一个 Error 对象，其中 err.code 为下文所列出的错误代码之一。

dns.resolve4(domain, callback)

于 dns.resolve() 一样，但只用于查询 IPv4（A 记录）。addresses 是一个 IPv4 地址的数组（比如

[‘74.125.79.104‘, ‘74.125.79.105‘,
 ‘74.125.79.106‘]

）。

dns.resolve6(domain, callback)

类似于 dns.resolve4()，但用于 IPv6（AAAA）查询。

dns.resolveMx(domain, callback)

类似于 dns.resolve()，但用于邮件交换查询（MX 记录）。

addresses 为一个 MX 记录的数组，每一项包含优先级和交换属性（比如

[{‘priority‘: 10, ‘exchange‘:
 ‘mx.example.com‘},...]

）。

dns.resolveTxt(domain, callback)

与 dns.resolve() 相似，但用于文本查询（TXT 记录）。addresses 为 domain 可用文本记录的数组（比如

[‘v=spf1
 ip4:0.0.0.0 ~all‘]

）。

dns.resolveSrv(domain, callback)

查询 SRV 记录，与 dns.resolve() 相似。 addresses 是域名 domain 可用的 SRV 记录数组，每一条记录都包含优先级（priority）、权重（weight）、端口号（port）、服务名称（name）等属性 (比如：

[{‘priority‘:
 10, {‘weight‘: 5, ‘port‘: 21223, ‘name‘: ‘service.example.com‘}, ...]

)。

dns.resolveNs(domain, callback)

查询 NS 记录，与 dns.resolve() 相似。 addresses 是域名 domain 可用的 NS 记录数组， (列如：[‘ns1.example.com‘, ‘ns2.example.com‘])。

dns.resolveCname(domain, callback)

查询 CNAME 记录，与 dns.resolve() 相似。 addresses 是域名 domain 可用的 CNAME 记录数组， (例如：[‘bar.example.com‘])。

dns.reverse(ip, callback)

反向解析 IP 地址，返回指向该 IP 地址的域名数组。

回调函数接收两个参数：

(err,
 domains)

。