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