Number.isSafeInteger()

試してみましょう

function warn(x) {
  if (Number.isSafeInteger(x)) {
    return "Precision safe.";
  }
  return "Precision may be lost!";
}

console.log(warn(Math.pow(2, 53)));
// 予想される結果: "Precision may be lost!"

console.log(warn(Math.pow(2, 53) - 1));
// 予想される結果: "Precision safe."

構文

Number.isSafeInteger(testValue)

引数

testValue

安全な整数かどうかをテストする値です。

返値

論理値で、与えられた数値が安全な整数である数値であれば true を返します。そうでなければ false です。

解説

安全な整数とは、 -(2⁵³ - 1) から 2⁵³ - 1 までのすべての整数であり、両端を含みます (±9,007,199,254,740,991)。安全な整数は次のようなものです。

• 正確に IEEE-754 倍精度数として表現することができる
• その IEEE-754 表現は、他の整数を IEEE-754 の表現に適合するように、丸めた結果にはならない

例えば、2⁵³ - 1 は安全な整数です。正確に表現することができ、他の整数は、どの IEEE-754 丸めモードの下で丸めたものにもなっていません。対照的に、2⁵³ は安全な整数ではありません。これは IEEE-754 で正確に表現できますが、整数値 2⁵³ + 1 は直接 IEEE-754 では表現できず、四捨五入や切り捨ての丸めによって 2⁵³ になるからです。

完全な精度で ~9 千兆より大きい値や小さい値を扱うには、任意精度演算ライブラリーを使用する必要があります。数値の浮動小数点表現の詳細については、 What Every Programmer Needs to Know about Floating Point Arithmetic を参照してください。s

巨大な整数値については、 BigInt 型を使用することを検討してください。

例

isSafeInteger() の使用

Number.isSafeInteger(3); // true
Number.isSafeInteger(2 ** 53); // false
Number.isSafeInteger(2 ** 53 - 1); // true
Number.isSafeInteger(NaN); // false
Number.isSafeInteger(Infinity); // false
Number.isSafeInteger("3"); // false
Number.isSafeInteger(3.1); // false
Number.isSafeInteger(3.0); // true

仕様書

ブラウザーの互換性

関連情報

• Number.isSafeInteger のポリフィル (core-js)
• es-shims による Number.isSafeInteger のポリフィル
• Number
• Number.MIN_SAFE_INTEGER
• Number.MAX_SAFE_INTEGER
• BigInt