CKTIS / JavaScript
Number.isSafeInteger: presné celé číslo v bezpečnom rozsahu
Number.isSafeInteger vráti true pre celočíselný Number od -(2^53−1) do 2^53−1, kde binary64 zachováva celočíselnú presnosť.
Verzia: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntax
Number.isSafeInteger(number)Number.isSafeInteger(value) vyžaduje konečnú celočíselnú hodnotu typu Number a Math.abs(value) <= Number.MAX_SAFE_INTEGER. Number.MAX_SAFE_INTEGER a Number.MIN_SAFE_INTEGER teda prejdú, hodnoty mimo rozsahu nie; +0 a -0 sú bezpečné. NaN, nekonečná a Numbers s reprezentovanou zlomkovou časťou dajú false.
Metóda nevykonáva koerciu, takže reťazce, BigInt, Symbol, objekty a obaly new Number(...) dajú false. Kontroluje už uloženú hodnotu binary64, nie pôvodný text pred parsovaním. Bezpečný aktuálny operand nezaručuje bezpečný ďalší výsledok: pripočítanie 1 k Number.MAX_SAFE_INTEGER opustí rozsah a rôzne matematické celé hodnoty sa potom môžu zaokrúhliť na rovnaký Number.
Metóda existuje od ECMAScript 2015 a nie je konštruktorom. Príklad zvýši nezáporné poradové číslo iba vtedy, ak zostane bezpečný aj výsledok, a hraničnú hodnotu odmietne. Pre počítadlá, identifikátory či sumy mimo rozsahu použite BigInt alebo desatinnú reprezentáciu; BigInt je presný, ale Number.isSafeInteger preň zámerne vracia false.
Prí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ýsledok
42 null true false true false false
Number.isSafeInteger → bezpečné zvýšenie poradového čísla