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

Object.isFiniteメソッドは、引数として渡された値が有限な数値であるかどうかを判定し、その結果をブール値（trueまたはfalse）で返すメソッドです。

ここでいう「有限な数値」とは、通常の整数や小数点以下の値を含む数値を指します。具体的には、Infinity（無限大）や-Infinity（負の無限大）、そしてNaN（Not-a-Number、数値ではないことを示す特殊な値）ではない数値のことです。

このメソッドの重要な特徴として、引数が数値ではない場合でも、まずその値を数値に変換しようと試みる点が挙げられます。例えば、文字列で表現された数値（例: "123"）やnull、trueのような値は、それぞれ123、0、1といった数値に変換されます。そして、この変換された結果が有限な数値であればtrueを返します。

もし変換の結果がInfinity、-Infinity、またはNaNとなる場合（例: "Hello"という文字列やundefinedが渡された場合）は、falseを返します。

このメソッドは、プログラムが予期しない無限大の値や無効な数値データを取り扱う前に、値の有効性を確認する際に非常に役立ちます。これにより、数値計算におけるエラーを未然に防ぎ、より堅牢なコードを記述できるようになります。

Copy
1console.log(Object.isFinite(0));
2console.log(Object.isFinite(123.45));
3console.log(Object.isFinite(-10));
4console.log(Object.isFinite(Infinity));
5console.log(Object.isFinite(-Infinity));
6console.log(Object.isFinite(NaN));
7console.log(Object.isFinite("123"));
8console.log(Object.isFinite(null));

value

• value: any: 判定対象の値

boolean

指定された値が有限な数値である場合は true を、そうでない場合は false を返します。