chrome.dns

説明

DNS 解決に chrome.dns API を使用します。

権限

dns

対象

<ph type="x-smartling-placeholder"></ph> Dev チャンネル

マニフェスト

この API を使用するには、マニフェストで "dns" 権限を宣言する必要があります。

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

注: この API は Chrome Dev でのみ利用できます。この API を Dev チャンネルから Chrome Stable チャンネルに移行する予定は、予定はありません。

用途

次のコードは、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

  数値

  結果コード。0 は成功を示します。

メソッド

resolve()

<ph type="x-smartling-placeholder"></ph> 約束

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

指定されたホスト名または IP アドレス リテラルを解決します。

パラメータ

• hostname

  文字列

  解決するホスト名。

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  (resolveInfo: ResolveCallbackResolveInfo) => void

  • resolveInfo

    ResolveCallbackResolveInfo

戻り値

• Promise&lt;ResolveCallbackResolveInfo&gt;

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。