Number.isSafeInteger()

{{JSRef}}

The Number.isSafeInteger() static method determines whether the provided value is a number that is a safe integer.

{{InteractiveExample("JavaScript Demo: Number.isSafeInteger()")}}

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

console.log(warn(Math.pow(2, 53)));
// Expected output: "Precision may be lost!"

console.log(warn(Math.pow(2, 53) - 1));
// Expected output: "Precision safe."

Syntax

Number.isSafeInteger(testValue)

Parameters

testValue
- : The value to be tested for being a safe integer.

Return value

The boolean value true if the given value is a number that is a safe integer. Otherwise false.

Description

The safe integers consist of all integers from -(2⁵³ - 1) to 2⁵³ - 1, inclusive (±9,007,199,254,740,991). A safe integer is an integer that:

can be exactly represented as an IEEE-754 double precision number, and
whose IEEE-754 representation cannot be the result of rounding any other integer to fit the IEEE-754 representation.

For example, 2⁵³ - 1 is a safe integer: it can be exactly represented, and no other integer rounds to it under any IEEE-754 rounding mode. In contrast, 2⁵³ is not a safe integer: it can be exactly represented in IEEE-754, but the integer 2⁵³ + 1 can’t be directly represented in IEEE-754 but instead rounds to 2⁵³ under round-to-nearest and round-to-zero rounding.

Handling values larger or smaller than ~9 quadrillion with full precision requires using an arbitrary precision arithmetic library. See What Every Programmer Needs to Know about Floating Point Arithmetic for more information on floating point representations of numbers.

For larger integers, consider using the {{jsxref("BigInt")}} type.

Examples

Using 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

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

docs.rodeo

MDN Web Docs mirror