Статический метод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."

Синтаксис

Number.isSafeInteger(testValue)

Параметры

testValue

Проверяемое значение.

Возвращаемое значение

Логическое значениеtrue если переданное значение является безопасным целым числом, в противном случаеfalse.

Описание

К безопасным целым числам относятся все целые числа от -(2⁵³ – 1) до 2⁵³ – 1 включительно (±9 007 199 254 740 991). Безопасное целое число — это целое число, которое:

• может быть точно представлено как число двойной точности по стандарту IEEE-754, и
• это представление не может быть результатом округления любого другого целого числа для соответствия представлению по стандарту IEEE-754.

Например, 2⁵³ - 1 является безопасным целым числом: оно может быть точно представлено, и никакое другое целое число не округляется до него ни при каком режиме округления IEEE-754. А вот 2⁵³не является безопасным целым числом: оно может быть точно представлено в IEEE-754, но целое число 2⁵³ + 1 не может быть представлено в IEEE-754, а вместо этого округляется до 2⁵³ при округлении до ближайшего и до нуля.

Обработка значений больше или меньше ~9 квадриллионов с полной точностью требует использования библиотек, поддерживающихарифметику произвольной точности. Дополнительную информацию о представлениях чисел с плавающей точкой смотрите вThe Floating-Point Guide (англ.).

Для бо́льших целых чисел рассмотрите возможность использования типаBigInt.

Примеры

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

Спецификации

Совместимость с браузерами

Смотрите также

• ПолифилNumber.isSafeInteger вcore-js
• Number
• Number.MIN_SAFE_INTEGER
• Number.MAX_SAFE_INTEGER
• BigInt