CKTIS / JavaScript
Number.isSafeInteger: inteiro exato no intervalo seguro
Number.isSafeInteger devolve true para um Number inteiro entre -(2^53−1) e 2^53−1, onde binary64 preserva a precisão inteira.
Versão: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintaxe
Number.isSafeInteger(number)Number.isSafeInteger(value) exige um valor finito e inteiro do tipo Number e Math.abs(value) <= Number.MAX_SAFE_INTEGER. Assim, Number.MAX_SAFE_INTEGER e Number.MIN_SAFE_INTEGER passam, mas valores fora do intervalo não; +0 e -0 são seguros. NaN, infinitos e Numbers com parte fracionária representada dão false.
O método não faz coerção, por isso strings, BigInt, Symbol, objetos e wrappers new Number(...) produzem false. Verifica o valor binary64 já armazenado, não o texto original antes do parsing. Um operando atual seguro não garante o resultado seguinte: somar 1 a Number.MAX_SAFE_INTEGER sai do intervalo, após o que inteiros matemáticos distintos podem arredondar para o mesmo Number.
O método existe desde ECMAScript 2015 e não é construtor. O exemplo incrementa um número de sequência não negativo apenas se o resultado continuar seguro e rejeita o limite. Para contadores, identificadores ou montantes além do intervalo, usa BigInt ou representação decimal; BigInt é exato, mas Number.isSafeInteger devolve-lhe intencionalmente false.
Exemplos
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));Resultado
42 null true false true false false
Number.isSafeInteger → incremento seguro de um número de sequência