Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Number.isSafeInteger: entero exacto en el rango seguro

Number.isSafeInteger devuelve true para un Number entero entre -(2^53−1) y 2^53−1, donde binary64 conserva precisión entera.

Versión: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintaxis

Number.isSafeInteger(number)

Number.isSafeInteger(value) exige un valor finito y entero de tipo Number y Math.abs(value) <= Number.MAX_SAFE_INTEGER. Por tanto, Number.MAX_SAFE_INTEGER y Number.MIN_SAFE_INTEGER pasan, pero no los valores fuera del rango; +0 y -0 son seguros. NaN, los infinitos y los Numbers con parte fraccionaria representada dan false.

El método no hace coerción, así que cadenas, BigInt, Symbol, objetos y envoltorios new Number(...) producen false. Comprueba el valor binary64 ya almacenado, no el texto original antes de analizarlo. Un operando actual seguro no garantiza que la operación siguiente sea segura: sumar 1 a Number.MAX_SAFE_INTEGER sale del rango, tras lo cual enteros matemáticos distintos pueden redondearse al mismo Number.

El método existe desde ECMAScript 2015 y no es constructor. El ejemplo incrementa un número de secuencia no negativo solo si el resultado seguirá siendo seguro y rechaza el límite. Para contadores, identificadores o importes más allá del rango, usa BigInt o representación decimal; BigInt es exacto, pero Number.isSafeInteger devuelve false para él de forma intencionada.

Ejemplos

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 un número de secuencia

Fuentes