【Node.js24.x】Number::isSafeInteger()メソッドの使い方
isSafeIntegerメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
isSafeIntegerメソッドは、与えられた値がJavaScriptで安全な整数であるかどうかを判定するメソッドです。JavaScriptにおける数値は、IEEE 754倍精度浮動小数点数形式で表現されており、これにより非常に大きな数や小数を扱えますが、すべての整数値を正確に表現できるわけではありません。安全な整数とは、その値が-2^53 + 1（-9,007,199,254,740,991）から2^53 - 1（9,007,199,254,740,991）の範囲内にあり、かつ整数である値を指します。この範囲外の整数値は、JavaScriptの数値表現の特性上、正確に表現できない可能性があり、計算結果に誤差が生じる危険性があります。
このメソッドは、引数として渡された値が以下の三つの条件をすべて満たす場合にtrueを返します。一つ目は、値がNumber型であること。二つ目は、値が整数であること。そして三つ目は、値が上述の安全な整数範囲内にあることです。これらの条件のいずれか一つでも満たさない場合はfalseを返します。例えば、浮動小数点数、Infinity、NaN、文字列、オブジェクト、または安全な範囲外の整数が渡された場合にはfalseとなります。このメソッドを使用することで、数値演算を行う前にデータの信頼性を確認し、予期せぬ丸め誤差や精度問題を防ぎ、堅牢なアプリケーションを開発するのに役立ちます。特に、IDや金額、数量など、正確な整数値が求められるデータの検証において非常に有効です。
構文(syntax)
1console.log(Number.isSafeInteger(10));
引数(parameters)
testValue
- testValue: number: 安全な整数かどうかをテストする値
戻り値(return)
boolean
指定された数値がJavaScriptの安全な整数範囲内にある場合にtrueを、それ以外の場合にfalseを返します。