Node.js dns.resolveCname() 方法

在本文中，您将了解 Node.js 的 dns.resolveCname() 函数，包括其语法、参数和示例。

Node.js dns.resolveCname() 函数是什么？

Node.js 的 dns.resolveCname() 方法用于解析给定主机名的 CNAME（规范名称）记录。它是一种 DNS 记录，用于将别名映射到真实的或规范的域名，称为 CNAME 记录。此方法包含在 DNS 模块中，该模块提供异步网络封装。

此方法专门用于获取与指定主机名关联的规范名称 (CNAME) 记录。CNAME 记录是 DNS 资源记录，可用于将别名主机名映射到规范（真实）主机名。

当调用 "dns.resolveCname()" 时，它会异步解析给定主机名的 CNAME 记录。它接受两个参数：一个用于处理结果的 回调函数 和要解析的 主机名。解析过程完成后，将调用回调方法。它提供两个参数：一个包含已解析 CNAME 记录的数组和一个错误对象（如果存在）。

语法

它具有以下语法：

参数

• 主机名 (Hostname): 此参数指定一个字符串。它是需要解析 CNAME 记录的域名。您希望将此别名映射到其规范名称。
• 回调 (Callback): 当发生错误或解析 CNAME 记录时执行的回调函数。回调函数使用两个参数：
  
  1. err: 这是一个错误对象。如果没有错误，则为 null。
  2. addresses: 这是一个字符串数组。数组中的每个字符串都表示与该主机名关联的 CNAME 记录。

返回值

此方法通过回调函数处理错误并返回它们，该函数将这些数据作为参数传递。

示例 1

让我们通过一个例子来说明 Node.js 的 dns.resolveCname() 函数。

输出

 
addresses: undefined  

说明

此代码演示了 Node.js dns 模块中 dns.resolveCname() 方法的使用。使用 require() 函数，首先导入 dns 模块。然后，使用主机名 'localhost' 调用 dns.resolveCname() 方法。通过此过程解析指定主机名的规范名称 (CNAME) 记录。它需要两个参数：一个用于处理结果的 回调 方法和要解析的 主机名。在此示例中，回调方法仅使用 console.log() 将解析的地址记录到控制台。为了使地址数组更易于理解，使用了 %j 占位符对日志语句进行了 JSON 格式化。此代码在执行时异步解析主机名 "localhost" 的 CNAME 记录，并将确定的地址打印到控制台。

回调函数中的 "err" 参数将接收在解析过程中发生的任何错误。

示例 2

让我们通过另一个例子来说明 Node.js 的 dns.resolveCname() 函数。

输出

 
CNAME records for www.github.com: github.com
Error resolving CNAME for www.google.com: queryCname ENODATA www.google.com
Error resolving CNAME for www.example.com: queryCname ENODATA www.example.com
Error resolving CNAME for www.nodejs.org: queryCname ENODATA www.nodejs.org
Error resolving CNAME for nonexistent.domain: queryCname ENOTFOUND nonexistent.domain   

说明

在此示例中，代码首先导入 DNS 模块 以定义需要解析 CNAME 条目的主机名列表。resolveCnameForHostname 方法可以解析单个主机名的 CNAME，该方法返回一个 Promise，该 Promise 要么解析为 CNAME 地址，要么因错误而拒绝。另一个名为 resolveCnamesForHostnames 的方法被定义为一个异步函数，它迭代主机名列表，解析每个主机名的 CNAME，并将结果收集到一个数组中。然后，调用 resolveCnamesForHostnames 函数后，处理其输出。将结果打印到终端，显示解析过程中发生的任何错误或已解析的 CNAME 地址。此方法确保每个主机名都被顺序处理，并妥善记录所有结果，无论是成功的还是错误的。