CKTIS / JavaScript
Number.isSafeInteger: intero esatto nell’intervallo sicuro
Number.isSafeInteger restituisce true per un Number intero tra -(2^53−1) e 2^53−1, dove binary64 conserva la precisione intera.
Versione: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintassi
Number.isSafeInteger(number)Number.isSafeInteger(value) richiede un valore finito e intero di tipo Number e Math.abs(value) <= Number.MAX_SAFE_INTEGER. Quindi Number.MAX_SAFE_INTEGER e Number.MIN_SAFE_INTEGER superano il test, non i valori esterni; +0 e -0 sono sicuri. NaN, gli infiniti e i Numbers con parte frazionaria rappresentata producono false.
Il metodo non esegue coercizione, quindi stringhe, BigInt, Symbol, oggetti e wrapper new Number(...) producono false. Controlla il valore binary64 già memorizzato, non il testo originale prima del parsing. Un operando attuale sicuro non garantisce il risultato successivo: aggiungere 1 a Number.MAX_SAFE_INTEGER esce dall’intervallo, dopo di che interi matematici distinti possono arrotondarsi allo stesso Number.
Il metodo esiste da ECMAScript 2015 e non è un costruttore. L’esempio incrementa un numero di sequenza non negativo solo se anche il risultato resterà sicuro e rifiuta il limite. Per contatori, identificatori o importi oltre l’intervallo usa BigInt o una rappresentazione decimale; BigInt è esatto, ma Number.isSafeInteger restituisce intenzionalmente false.
Esempi
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));Risultato
42 null true false true false false
Number.isSafeInteger → incremento sicuro di un numero di sequenza