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

CKTIS / JavaScript

Number.MAX_SAFE_INTEGER : limite supérieure des entiers sûrs

Number.MAX_SAFE_INTEGER vaut exactement 2^53−1, soit 9007199254740991, et marque la limite positive des entiers sûrs de Number.

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

Syntaxe

Number.MAX_SAFE_INTEGER

Number.MAX_SAFE_INTEGER vaut 2 ** 53 - 1, exactement 9007199254740991. Les valeurs Number entières de Number.MIN_SAFE_INTEGER jusqu’à cette limite sont sûres : les entiers consécutifs peuvent être représentés sans collision d’arrondi. Cette constante n’est pas le plus grand Number fini ; ce rôle revient au bien plus grand Number.MAX_VALUE.

2 ** 53 reste exactement représentable, mais n’est pas classé comme sûr, car tous les entiers consécutifs ne sont plus distinguables. Par exemple, Number.MAX_SAFE_INTEGER + 1 et Number.MAX_SAFE_INTEGER + 2 produisent le même Number. Vérifier seulement après la conversion d’un long identifiant textuel peut être trop tard, car l’analyse peut déjà avoir perdu de la précision.

La propriété existe depuis ECMAScript 2015 et n’est ni modifiable, ni énumérable, ni configurable. L’exemple valide un identifiant non négatif avec Number.isSafeInteger et la limite explicite, puis montre la première collision. Pour de plus grands identifiants, conservez le texte ou utilisez BigInt au lieu de les convertir en Number.

Exemples

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

Résultat

9007199254740991 true
true
true false
false false false

Number.MAX_SAFE_INTEGER → validation d’identifiant et première collision d’arrondi

Sources