База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Number.isSafeInteger: точно цяло число в безопасния диапазон

Number.isSafeInteger връща true за целочислен Number от -(2^53−1) до 2^53−1, където binary64 запазва целочислената точност.

Версия: ECMAScript 2015 onward; example target: Node.js 24.22.2

Синтаксис

Number.isSafeInteger(number)

Number.isSafeInteger(value) изисква крайна целочислена стойност от тип Number и Math.abs(value) <= Number.MAX_SAFE_INTEGER. Затова Number.MAX_SAFE_INTEGER и Number.MIN_SAFE_INTEGER минават, а стойности извън диапазона не; +0 и -0 са безопасни. NaN, безкрайностите и Numbers с представена дробна част дават false.

Методът не извършва преобразуване, затова низове, BigInt, Symbol, обекти и обвивки new Number(...) дават false. Той проверява вече съхранената binary64 стойност, не оригиналния текст преди парсване. Безопасен текущ операнд не гарантира безопасен следващ резултат: добавянето на 1 към Number.MAX_SAFE_INTEGER излиза от диапазона, след което различни математически цели числа може да се закръглят до един и същ Number.

Методът съществува от ECMAScript 2015 и не е конструктор. Примерът увеличава неотрицателен пореден номер само ако и резултатът ще остане безопасен, и отхвърля граничната стойност. За броячи, идентификатори или суми извън диапазона използвай BigInt или десетично представяне; BigInt е точен, но Number.isSafeInteger умишлено връща false за него.

Примери

function nextSequence(value) {
  if (!Number.isSafeInteger(value) || value < 0 || value >= Number.MAX_SAFE_INTEGER) return null;
  return value + 1;
}

console.log(nextSequence(41), nextSequence(Number.MAX_SAFE_INTEGER));
console.log(Number.isSafeInteger(Number.MAX_SAFE_INTEGER), Number.isSafeInteger(Number.MAX_SAFE_INTEGER + 1));
console.log(Number.isSafeInteger(-0), Number.isSafeInteger("42"), Number.isSafeInteger(42n));

Резултат

42 null
true false
true false false

Number.isSafeInteger → безопасно увеличаване на пореден номер

Източници