Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Number.isSafeInteger : entier exact dans l’intervalle sûr

Number.isSafeInteger renvoie true pour un Number entier de -(2^53−1) à 2^53−1, où binary64 préserve la précision entière.

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

Syntaxe

Number.isSafeInteger(number)

Number.isSafeInteger(value) exige une valeur finie et entière de type Number ainsi que Math.abs(value) <= Number.MAX_SAFE_INTEGER. Number.MAX_SAFE_INTEGER et Number.MIN_SAFE_INTEGER passent donc le test, mais pas les valeurs hors de cet intervalle ; +0 et -0 sont sûrs. NaN, les infinis et les Numbers avec une partie fractionnaire représentée donnent false.

La méthode n’effectue aucune coercition : chaînes, BigInt, Symbol, objets et wrappers new Number(...) donnent false. Elle teste la valeur binary64 déjà stockée, non le texte original avant analyse. Un opérande actuellement sûr ne garantit pas que l’opération suivante le soit : ajouter 1 à Number.MAX_SAFE_INTEGER sort de l’intervalle, après quoi des entiers mathématiques distincts peuvent s’arrondir au même Number.

La méthode existe depuis ECMAScript 2015 et n’est pas un constructeur. L’exemple incrémente un numéro de séquence non négatif uniquement si le résultat restera sûr et refuse la limite. Pour des compteurs, identifiants ou montants au-delà de l’intervalle, utilisez BigInt ou une représentation décimale ; BigInt est exact, mais Number.isSafeInteger renvoie volontairement false pour lui.

Exemples

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

Résultat

42 null
true false
true false false

Number.isSafeInteger → incrément sûr d’un numéro de séquence

Sources