CKTIS / JavaScript
Number.isSafeInteger: dokładna liczba całkowita w bezpiecznym zakresie
Number.isSafeInteger zwraca true dla całkowitej wartości Number od -(2^53−1) do 2^53−1, którą binary64 reprezentuje bez utraty całkowitej precyzji.
Wersja: ECMAScript 2015 onward; example target: Node.js 24.22.2
Składnia
Number.isSafeInteger(number)Number.isSafeInteger(value) wymaga skończonej, całkowitej wartości typu Number oraz Math.abs(value) <= Number.MAX_SAFE_INTEGER. Zatem Number.MAX_SAFE_INTEGER i Number.MIN_SAFE_INTEGER przechodzą test, ale wartości poza tym zakresem nie; +0 i -0 są bezpieczne. NaN, nieskończoności i liczby z reprezentowaną częścią ułamkową dają false.
Metoda nie wykonuje koercji, więc łańcuchy, BigInt, Symbol, obiekty i new Number(...) dają false. Sprawdza już zapisaną wartość binary64, nie oryginalny tekst przed parsowaniem. Bezpieczny bieżący operand nie gwarantuje bezpiecznego wyniku następnego działania: dodanie 1 do Number.MAX_SAFE_INTEGER wychodzi poza zakres, a różne matematyczne liczby całkowite mogą wtedy zaokrąglać się do tego samego Number.
Metoda istnieje od ECMAScript 2015 i nie jest konstruktorem. Przykład bezpiecznie zwiększa nieujemny numer sekwencji tylko wtedy, gdy także wynik pozostanie w zakresie, i odrzuca wartość graniczną. Dla liczników, identyfikatorów lub kwot przekraczających zakres użyj BigInt albo reprezentacji dziesiętnej; BigInt jest dokładny, lecz Number.isSafeInteger celowo zwraca dla niego false.
Przykłady
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));Wynik
42 null true false true false false
Number.isSafeInteger → bezpieczne zwiększanie numeru sekwencji