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

valueOfメソッドは、Numberオブジェクトのプリミティブな数値表現を返すメソッドです。

このメソッドは、JavaScriptのNumberコンストラクタ（例えば、new Number(123)のように）によって作成された数値オブジェクトが内部に保持している、実際の数値そのもの、つまりプリミティブな数値の値を取得するために使用されます。JavaScriptでは通常、数値は42のようなプリミティブ値として直接扱われますが、特定の場面では数値オブジェクトとして表現されることがあります。valueOfメソッドは、このような数値オブジェクトから、算術演算などで直接利用できる純粋な数値を取り出す役割を担います。

例えば、new Number(42)というNumberオブジェクトに対してvalueOf()メソッドを呼び出すと、その結果はプリミティブな数値である42になります。これは、数値オブジェクトを数学的な計算や比較などの操作で直接使用できるように変換する際に特に有効です。

多くの場合、JavaScriptエンジンは、数値オブジェクトを数値として扱う必要がある文脈で、このvalueOfメソッドを自動的に呼び出してくれます。しかし、開発者が明示的にオブジェクトからプリミティブな数値を取得したい場合や、期待されるデータの型を明確にしたい場合に、このメソッドを直接呼び出すことができます。

この機能は、データ型の変換を理解し、オブジェクトとプリミティブ値の区別がプログラミングにおいて基礎的な概念であることを示しています。

Copy
1const num = new Number(123);
2const primitiveValue = num.valueOf();
3console.log(primitiveValue);

引数なし

引数はありません

number

Number オブジェクトのプリミティブな数値値を返します。