chrome.dns

說明

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

權限

dns

可用性

開發人員管道

如要使用這個 API，您必須在manifest中宣告 "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 選填

  代表 IP 位址常值的字串。只有在 resultCode 表示成功時才會提供。

• resultCode

  數字

  結果代碼。零表示成功。

方法

resolve()

Promise

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

解析指定的主機名稱或 IP 位址文字。

參數

• 主機名稱

  字串

  要解析的主機名稱。

• 回呼

  函式 選填

  callback 參數如下所示：

  (resolveInfo: ResolveCallbackResolveInfo) => void

  • resolveInfo

    ResolveCallbackResolveInfo

傳回

• Promise<ResolveCallbackResolveInfo>

  承諾在資訊清單 3 以上版本中受支援，但回呼則是為了回溯相容性而提供。您無法在同一個函式呼叫中同時使用這兩種方法。承諾會以傳遞至回呼的相同類型解析。