Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Number.MAX_SAFE_INTEGER: limite superiore degli interi sicuri

Number.MAX_SAFE_INTEGER ha il valore esatto 2^53−1, cioè 9007199254740991, e segna il limite positivo degli interi sicuri di Number.

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

Sintassi

Number.MAX_SAFE_INTEGER

Number.MAX_SAFE_INTEGER equivale a 2 ** 53 - 1, esattamente 9007199254740991. I valori Number interi da Number.MIN_SAFE_INTEGER fino a questo limite sono sicuri: gli interi consecutivi si rappresentano senza collisioni di arrotondamento. La costante non è il più grande Number finito; quel ruolo spetta al molto maggiore Number.MAX_VALUE.

2 ** 53 è ancora rappresentabile esattamente, ma non è classificato come sicuro perché non tutti gli interi consecutivi restano distinguibili. Per esempio Number.MAX_SAFE_INTEGER + 1 e Number.MAX_SAFE_INTEGER + 2 producono lo stesso Number. Controllare solo dopo aver convertito un lungo identificatore testuale può essere troppo tardi, perché il parsing può avere già perso precisione.

La proprietà esiste da ECMAScript 2015 e non è scrivibile, enumerabile né configurabile. L’esempio convalida un identificatore non negativo con Number.isSafeInteger e il limite esplicito, poi mostra la prima collisione. Per identificatori maggiori conserva il testo o usa BigInt invece di convertirli in Number.

Esempi

const limit = Number.MAX_SAFE_INTEGER;
const validId = value => Number.isSafeInteger(value) && value >= 0 && value <= limit;

console.log(limit, limit === 2 ** 53 - 1);
console.log(limit + 1 === limit + 2);
console.log(validId(limit), validId(limit + 1));
const descriptor = Object.getOwnPropertyDescriptor(Number, "MAX_SAFE_INTEGER");
console.log(descriptor.writable, descriptor.enumerable, descriptor.configurable);

Risultato

9007199254740991 true
true
true false
false false false

Number.MAX_SAFE_INTEGER → convalida identificatore e prima collisione di arrotondamento

Fonti