dnsPromises.lookup(hostname[, options])

• hostname <string>
• options <integer> | <Object>
  • family <integer> 记录的类型。必须是 4、6 或 0。值 0 表示返回的是 IPv4 或 IPv6 地址。如果在 { all: true }（见下文）中使用值 0，则根据系统的 DNS 解析器，可能返回其中一种或两种地址。默认值：0。
  • hints <number> 一个或多个 支持的 getaddrinfo 标志。可以通过按位 OR 运算传递多个标志。
  • all <boolean> 当为 true 时，Promise 会返回包含所有地址的数组。否则，只返回一个地址。默认值： false。
  • order <string> 当为 verbatim 时，Promise 会按 DNS 解析器返回的顺序解析 IPv4 和 IPv6 地址。 当为 ipv4first 时，IPv4 地址会排在 IPv6 地址之前。 当为 ipv6first 时，IPv6 地址会排在 IPv4 地址之前。 默认值： verbatim（地址不会重新排序）。 默认值可以通过 dns.setDefaultResultOrder() 或 --dns-result-order 配置。 新代码应使用 { order: 'verbatim' }。
  • verbatim <boolean> 当 true 时，Promise 会按 DNS 解析器返回的顺序解析 IPv4 和 IPv6 地址。当 false 时，IPv4 地址会放在 IPv6 地址之前。此选项将被弃用，取而代之的是 order。当两者都指定时，order 优先。新代码应仅使用 order。默认值： 目前为 false（地址会被重新排序），但预计在不久的将来会改变。默认值可使用 dns.setDefaultResultOrder() 或 --dns-result-order 配置。

将主机名（例如 'nodejs.org'）解析为找到的第一个 A（IPv4）或 AAAA（IPv6）记录。所有 option 属性都是可选的。如果 options 是整数，则必须为 4 或 6 —— 如果未提供 options，则在找到时返回 IPv4 或 IPv6 地址，或两者。

【Resolves a host name (e.g. 'nodejs.org') into the first found A (IPv4) or AAAA (IPv6) record. All option properties are optional. If options is an integer, then it must be 4 or 6 – if options is not provided, then either IPv4 or IPv6 addresses, or both, are returned if found.】

当 all 选项设置为 true 时，Promise 会被解析为 addresses，它是一个对象数组，每个对象包含 address 和 family 属性。

【With the all option set to true, the Promise is resolved with addresses being an array of objects with the properties address and family.】

在出错时，Promise 会被 Error 对象拒绝，其中 err.code 是错误代码。请记住，err.code 不仅在主机名不存在时会被设置为 'ENOTFOUND'，在其他查找失败的情况下（例如没有可用的文件描述符）也会如此。

【On error, the Promise is rejected with an Error object, where err.code is the error code. Keep in mind that err.code will be set to 'ENOTFOUND' not only when the host name does not exist but also when the lookup fails in other ways such as no available file descriptors.】

dnsPromises.lookup() 不一定与 DNS 协议有任何关系。该实现使用操作系统的功能，可以将名称与地址相互关联。此实现可能对任何 Node.js 程序的行为产生微妙但重要的影响。在使用 dnsPromises.lookup() 之前，请花一些时间查阅 实现考虑部分。

用法示例：

【Example usage:】

import dns from 'node:dns';
const dnsPromises = dns.promises;
const options = {
  family: 6,
  hints: dns.ADDRCONFIG | dns.V4MAPPED,
};

await dnsPromises.lookup('example.org', options).then((result) => {
  console.log('address: %j family: IPv%s', result.address, result.family);
  // address: "2606:2800:21f:cb07:6820:80da:af6b:8b2c" family: IPv6
});

// When options.all is true, the result will be an Array.
options.all = true;
await dnsPromises.lookup('example.org', options).then((result) => {
  console.log('addresses: %j', result);
  // addresses: [{"address":"2606:2800:21f:cb07:6820:80da:af6b:8b2c","family":6}]
});const dns = require('node:dns');
const dnsPromises = dns.promises;
const options = {
  family: 6,
  hints: dns.ADDRCONFIG | dns.V4MAPPED,
};

dnsPromises.lookup('example.org', options).then((result) => {
  console.log('address: %j family: IPv%s', result.address, result.family);
  // address: "2606:2800:21f:cb07:6820:80da:af6b:8b2c" family: IPv6
});

// When options.all is true, the result will be an Array.
options.all = true;
dnsPromises.lookup('example.org', options).then((result) => {
  console.log('addresses: %j', result);
  // addresses: [{"address":"2606:2800:21f:cb07:6820:80da:af6b:8b2c","family":6}]
});拷贝