Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Number.MAX_SAFE_INTEGER: limite superior dos inteiros seguros

Number.MAX_SAFE_INTEGER tem o valor exato 2^53−1, ou 9007199254740991, e marca o limite positivo dos inteiros seguros de Number.

Versão: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintaxe

Number.MAX_SAFE_INTEGER

Number.MAX_SAFE_INTEGER é igual a 2 ** 53 - 1, exatamente 9007199254740991. Valores Number inteiros desde Number.MIN_SAFE_INTEGER até este limite são seguros: inteiros consecutivos podem ser representados sem colisões de arredondamento. A constante não é o maior Number finito; esse papel pertence ao muito maior Number.MAX_VALUE.

2 ** 53 ainda é exatamente representável, mas não é classificado como seguro porque nem todos os inteiros consecutivos continuam distinguíveis. Por exemplo, Number.MAX_SAFE_INTEGER + 1 e Number.MAX_SAFE_INTEGER + 2 produzem o mesmo Number. Verificar apenas depois de converter um identificador textual longo pode ser tarde demais, pois o parsing pode já ter perdido precisão.

A propriedade existe desde ECMAScript 2015 e não é gravável, enumerável nem configurável. O exemplo valida um identificador não negativo com Number.isSafeInteger e o limite explícito, mostrando depois a primeira colisão. Para identificadores maiores, preserva o texto ou usa BigInt em vez de os converter para Number.

Exemplos

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);

Resultado

9007199254740991 true
true
true false
false false false

Number.MAX_SAFE_INTEGER → validação de identificador e primeira colisão de arredondamento

Fontes