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

屬性

• 地址

  string optional

  代表 IP 位址常值的字串。僅在 resultCode 表示成功時提供。

• resultCode

  數字

  結果代碼。零表示成功。

方法

resolve()

Promise

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

解析指定的主機名稱或 IP 位址常值。

參數

• 主機名稱

  字串

  要解析的主機名稱。

• 回呼

  函式 選用

  callback 參數如下所示：

  (resolveInfo: ResolveCallbackResolveInfo) => void

  • resolveInfo

    ResolveCallbackResolveInfo

傳回

• Promise<ResolveCallbackResolveInfo>

  Promise 適用於 Manifest V3 及以上版本，但系統會為 回溯相容性您無法在同一函式呼叫中同時使用兩者。 保證會以傳遞至回呼的相同類型來解析。