chrome.dns

说明

使用 chrome.dns API 进行 DNS 解析。

权限

dns

可用性

开发者版

如需使用此 API，您必须在清单中声明 "dns" 权限。

{
  "name": "My extension",
  ...
  "permissions": [
    "dns"
  ],
  ...
}

注意：此 API 仅在 Chrome 开发者版中提供。我们预计目前不会打算将此 API 从开发者版移至 Chrome 稳定版。

用法

以下代码调用 resolve() 来检索 example.com 的 IP 地址。

service-worker.js：

const resolveDNS = async () => {
    let record = await chrome.dns.resolve('example.com');
    console.log(record.address); // "192.0.2.172"
};

resolveDNS();

要点：请勿在主机名中添加架构或结尾斜杠。例如，https://example.com/ 无效。

类型

ResolveCallbackResolveInfo

属性

• 地址

  字符串（可选）

  表示 IP 地址字面量的字符串。仅在 resultCode 指示成功时提供。

• resultCode

  number

  结果代码。零表示成功。

方法

resolve()

Promise

chrome.dns.resolve(
  hostname: string,
  callback?: function,
)

解析给定的主机名或 IP 地址字面量。

参数

• hostname

  string

  要解析的主机名。

• callback

  函数（可选）

  callback 参数如下所示：

  (resolveInfo: ResolveCallbackResolveInfo)=>void

  • resolveInfo

    ResolveCallbackResolveInfo

返回

• Promise<ResolveCallbackResolveInfo>

  Manifest V3 及更高版本支持 promise，但提供回调以实现向后兼容性。您不能在同一个函数调用中同时使用这两者。promise 使用传递给回调函数的同一类型进行解析。