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

V4MAPPEDプロパティは、IPv4アドレスがIPv6アドレスとして表現されている状態を示す情報を保持するプロパティです。主にNode.jsのネットワーク関連モジュールにおいて、取得したIPアドレス情報がIPv4-mapped IPv6アドレスであるか否かを識別するために使用されます。

IPv4-mapped IPv6アドレスとは、IPv6のアドレス形式を保ちながらも、実際にはIPv4アドレスを表す特殊な形式のアドレスであり、IPv6ネットワークとIPv4ネットワークが混在するデュアルスタック環境で、両方のアドレスタイプを透過的に扱うために利用されます。

このプロパティは通常、真偽値（trueまたはfalse）を保持し、取得したIPアドレスがIPv4-mapped IPv6アドレスである場合にtrueを、そうでない場合にfalseを示します。システムエンジニアがアプリケーションでIPアドレスを取り扱う際、このプロパティを参照することで、アドレスの実際のタイプを正確に判別し、IPv4とIPv6の両方に対応した柔軟なネットワーク処理を実装できます。例えば、dns.lookup()関数の結果オブジェクトや、netモジュールのソケット情報オブジェクトに含まれることがあります。これにより、開発者はアドレスタイプに応じた適切なロジックを適用することが可能となり、ネットワーク通信の信頼性と互換性を高める上で重要な役割を果たします。

Copy
1import { lookup } from 'dns';
2
3lookup('localhost', {
4  family: 6,
5  V4MAPPED: true
6}, (err, address, family) => {
7  if (err) throw err;
8  console.log(address, family);
9});

引数なし

引数はありません

戻り値なし

戻り値はありません