【Node.js24.x】Object::ADDRCONFIGプロパティの使い方

ADDRCONFIGプロパティは、Node.jsのdnsモジュールにおける名前解決の動作を制御するための設定を保持するプロパティです。主に、ドメイン名をIPアドレスに変換する際に、解決されるIPアドレスのプロトコルバージョン（IPv4またはIPv6）をシステムの状態に基づいてフィルタリングするかどうかを決定します。

このプロパティがtrueに設定されている場合、Node.jsは、現在システム上で設定されているネットワークインターフェースがサポートしているIPアドレスの種類のみを名前解決の結果として返します。例えば、もしシステムがIPv6アドレスを利用できない状態であれば、対象のドメイン名がIPv6アドレスを持っていても、そのIPv6アドレスは名前解決の結果として提供されません。これにより、システムが到達できないIPアドレスへの接続試行を防ぎ、ネットワーク通信の無駄を省き、より効率的で安定した接続確立を促進します。

ADDRCONFIGプロパティは、通常、dns.lookup()のような名前解決を行う関数にオプションオブジェクトの一部として渡され、特定のネットワーク環境下での挙動を最適化するために使用されます。これにより、開発者は自身のアプリケーションが意図しないIPプロトコルでの通信を試みることを防ぎ、信頼性の高いネットワーク処理を構築することが可能になります。

Copy
1import dns from 'dns';
2
3dns.lookup('example.com', { hints: dns.ADDRCONFIG }, (err, address, family) => {
4  if (err) {
5    console.error(err);
6    return;
7  }
8  console.log(`Resolved address: ${address}, family: IPv${family}`);
9});

引数なし

引数はありません

number

ADDRCONFIGは、ソケットアドレス設定のためのコンフィギュレーションオプションを表す数値です。この値はビットフラグとして扱われ、IPv4とIPv6アドレスのどちらを優先するかなどの設定を制御するために使用されます。