【JavaScript ECMAScript】Number::Number.prototype.valueOfインスタンスメソッドの使い方

Number.prototype.valueOf()メソッドは、Numberオブジェクトのプリミティブな値を取得するメソッドです。JavaScriptにおいて、数値には直接的な数値である「プリミティブな数値」と、数値をラップした「Numberオブジェクト」の二種類があります。Numberオブジェクトは、new Number(値)のようにして生成され、プリミティブな数値とは異なる特性を持ちます。このvalueOf()メソッドは、そのようなNumberオブジェクトが内包している、本来のプリミティブな数値を取り出して返します。

通常、JavaScriptエンジンは、Numberオブジェクトを算術演算の対象とする場合や、比較演算子で評価する場合など、オブジェクトをプリミティブな数値として扱う必要がある場面で、このvalueOf()メソッドを自動的に呼び出します。これにより、開発者が明示的に変換のコードを書かなくても、Numberオブジェクトが数値として適切に機能します。このメソッドを開発者が直接呼び出すことは稀ですが、Numberオブジェクトからその本質的なプリミティブ値を確実に取得したい場合に利用できます。valueOf()は、JavaScriptの柔軟な型システムにおいて、オブジェクトとプリミティブ値間の円滑な相互作用を支える重要な役割を担っています。

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

引数なし

引数はありません

number

Number.prototype.valueOf() は、Numberオブジェクトのプリミティブな数値値を返します。