【Node.js24.x】Number::isFinite()メソッドの使い方
isFiniteメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
Number.isFiniteメソッドは、与えられた値が有限数であるかどうかを判定するメソッドです。このメソッドは、Numberオブジェクトに直接呼び出す静的メソッドであり、引数として検証したい値を一つ受け取ります。
引数が通常の数値（整数や小数など）であり、かつInfinity（無限大）、-Infinity（負の無限大）、NaN（非数）のいずれでもない場合にのみtrueを返します。これらの特殊な数値が引数として渡された場合はfalseを返します。
さらに重要な点として、このNumber.isFiniteメソッドは、引数を数値に型変換しようとはしません。そのため、数値型ではない値（例えば文字列やオブジェクトなど）が渡された場合も、その値が数値に変換可能であっても、常にfalseを返します。これは、グローバルなisFinite()関数との主な違いであり、Number.isFiniteはより厳密な数値の検証に適しています。
このメソッドは、数値計算を行う前に、入力値が有効な有限数であることを確認するために非常に有用です。例えば、ユーザーからの入力値が意図しない無限大や非数であった場合に、その後の計算処理でエラーが発生するのを防ぎ、プログラムの安定性を向上させることができます。
構文(syntax)
1console.log(Number.isFinite(123)); 2console.log(Number.isFinite(Infinity)); 3console.log(Number.isFinite(NaN)); 4console.log(Number.isFinite("123"));
引数(parameters)
value
- value: number: 判定対象の数値
戻り値(return)
boolean
Number.prototype.isFinite() メソッドは、引数として渡された数値が有限である場合に true を、無限大 (Infinity, -Infinity) または NaN (Not-a-Number) である場合に false を返します。