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