【Node.js24.x】Number::MIN_SAFE_INTEGER定数の使い方
MIN_SAFE_INTEGER定数の使い方について、初心者にもわかりやすく解説します。
基本的な使い方
Number.MIN_SAFE_INTEGER定数は、JavaScript（Node.js）において安全に表現できる最小の整数値を表す定数です。その具体的な値は-9007199254740991であり、これは2の53乗から1を引いた値にマイナスをつけたものに相当します。
JavaScriptでは、数値は内部的にIEEE 754倍精度浮動小数点形式で扱われます。この形式では、すべての整数を無限に正確に表現できるわけではなく、正確に表現できる整数の範囲に限界があります。Number.MIN_SAFE_INTEGERは、この形式で正確な整数として扱える最も小さい値を示しています。
「安全に表現できる」とは、この値とNumber.MAX_SAFE_INTEGER（最大の安全な整数）の間の整数値であれば、小数点以下を含まない完全に正確な数値として表現でき、計算結果も正確であると保証されることを意味します。この範囲を超える、つまりNumber.MIN_SAFE_INTEGERよりも小さい整数値で計算を行った場合、JavaScriptの数値型では正確な結果が得られず、値の一部が失われたり、意図しない丸めが行われたりする可能性があります。
特に、データベースのIDや金融関連の計算など、厳密な整数値の精度が要求される場面では、この定数が示す範囲を意識することが非常に重要です。もしNumber.MIN_SAFE_INTEGERよりも小さい負の整数を扱う必要がある場合は、JavaScriptのBigIntデータ型を使用することで、任意の大きさの整数を精度を損なうことなく安全に扱うことが推奨されます。この定数はNumberオブジェクトに直接所属しているため、Number.MIN_SAFE_INTEGERとしてアクセスして利用できます。
構文(syntax)
1console.log(Number.MIN_SAFE_INTEGER);
引数(parameters)
引数なし
引数はありません
戻り値(return)
number
Number.MIN_SAFE_INTEGER は、JavaScriptにおいて表現できる安全な整数の最小値を表す定数です。この値は、正確な整数演算を保証できる最小の整数であり、これより小さい整数は精度が失われる可能性があります。