【Node.js24.x】Object::setDefaultAutoSelectFamily()メソッドの使い方

setDefaultAutoSelectFamilyメソッドは、Node.jsのDNSモジュールにおいて、DNSクエリ時にIPアドレスファミリー（IPv4またはIPv6）の自動選択機能を有効または無効にするメソッドです。このメソッドは、引数としてブール値のenableを受け取ります。enableにtrueを設定すると、Node.jsアプリケーションがDNS名前解決を行う際に、システムが利用可能なIPアドレスファミリーを自動的に判断し、適切なアドレスを返すようになります。

具体的には、この機能が有効になると、dns.lookup()などのDNS解決処理において、dns.ADDRCONFIGとdns.V4MAPPEDというヒントオプションが暗黙的に適用されます。dns.ADDRCONFIGは、ローカルシステムのIPアドレス構成に基づいて、適切なIPアドレスファミリーのアドレス（例えば、システムがIPv4のみをサポートしていればIPv4アドレス）を優先的に返すように指定します。一方、dns.V4MAPPEDは、IPv6アドレスを要求した場合に、IPv4アドレスをIPv6形式にマッピングして返すことを可能にし、IPv6ネットワーク環境でのIPv4互換性を向上させます。

このメソッドを使用することで、開発者はNode.jsアプリケーション全体のDNS解決のデフォルト挙動をグローバルに設定でき、ネットワーク環境の変化に柔軟に対応できるようになります。特に、IPv4とIPv6の両方が混在するデュアルスタック環境において、アプリケーションの名前解決戦略を調整し、より堅牢なネットワーク接続を実現するために役立ちます。

Copy
1const dns = require('dns');
2dns.setDefaultAutoSelectFamily(true);

value

• value: boolean: IPアドレスファミリーの自動選択をデフォルトで有効にするか無効にするかを指定します。trueを指定すると有効になり、falseを指定すると無効になります。

戻り値なし

戻り値はありません