Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Number.isSafeInteger: přesné celé číslo v bezpečném rozsahu

Number.isSafeInteger vrátí true pro celočíselný Number od -(2^53−1) do 2^53−1, kde binary64 zachovává celočíselnou přesnost.

Verze: ECMAScript 2015 onward; example target: Node.js 24.22.2

Syntaxe

Number.isSafeInteger(number)

Number.isSafeInteger(value) vyžaduje konečnou celočíselnou hodnotu typu Number a Math.abs(value) <= Number.MAX_SAFE_INTEGER. Number.MAX_SAFE_INTEGER a Number.MIN_SAFE_INTEGER tedy projdou, hodnoty mimo rozsah ne; +0 a -0 jsou bezpečné. NaN, nekonečna a Numbers s reprezentovanou zlomkovou částí dají false.

Metoda neprovádí koerci, takže řetězce, BigInt, Symbol, objekty a obaly new Number(...) dají false. Kontroluje již uloženou hodnotu binary64, nikoli původní text před parsováním. Bezpečný současný operand nezaručuje bezpečný další výsledek: přičtení 1 k Number.MAX_SAFE_INTEGER opustí rozsah a různé matematické celé hodnoty se pak mohou zaokrouhlit na stejný Number.

Metoda existuje od ECMAScript 2015 a není konstruktorem. Příklad zvýší nezáporné pořadové číslo jen tehdy, zůstane-li bezpečný i výsledek, a mezní hodnotu odmítne. Pro čítače, identifikátory či částky mimo rozsah použijte BigInt nebo desetinnou reprezentaci; BigInt je přesný, ale Number.isSafeInteger pro něj záměrně vrací false.

Příklady

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));

Výsledek

42 null
true false
true false false

Number.isSafeInteger → bezpečné zvýšení pořadového čísla

Zdroje