Number.isSafeInteger()

Exemple interactif

function warn(x) {
  if (Number.isSafeInteger(x)) {
    return "Precision safe.";
  }
  return "Precision may be lost!";
}

console.log(warn(Math.pow(2, 53)));
// Expected output: "Precision may be lost!"

console.log(warn(Math.pow(2, 53) - 1));
// Expected output: "Precision safe."

Syntaxe

Number.isSafeInteger(valeurTester);

Paramtres

valeurTester

La valeur dont on souhaite savoir si elle reprsente un entier reprsentable correctement en une valeur non signe sur 32 bits. (JavaScript utilise les nombres au format de virgule flottante double prcision comme spcifi dans IEEE 754 et ne peut reprsenter avec certitude un entier qu'entre -(2^53-1) et 2^53-1 (c'est--dire 9007199254740991).

Valeur de retour

Un boolen qui indique si la valeur fournie en argument est un entier reprsentable correctement en JavaScript.

Description

Un entier correctement reprsentable en JavaScript :

• peut exactement tre reprsent avec un nombre prcision double selon IEEE-754
• la rprsentation IEEE-754 du nombre ne permet pas de l'arrondir un autre entier pouvant tre reprsent avec le format dcrit par IEEE-754.

Ainsi, par exemple, 2^53 - 1 peut tre reprsent correctement, aucun autre entier ne peut tre arrondi en cette valeur selon IEEE-754. En revanche, 2^53 ne peut pas tre reprsent correctement car 2^53 + 1 sera arrondi en 2^53 selon les rgles IEEE-754 (arrondi l'entier le plus proche).

L'intervalle des entiers qui peuvent tre correctement reprsents est [-(2^53 - 1),2^53 - 1 ].

Exemples

Number.isSafeInteger(3); // true
Number.isSafeInteger(Math.pow(2, 53)); // false
Number.isSafeInteger(Math.pow(2, 53) - 1); // true
Number.isSafeInteger(NaN); // false
Number.isSafeInteger(Infinity); // false
Number.isSafeInteger("3"); // false
Number.isSafeInteger(3.1); // false
Number.isSafeInteger(3.0); // true

Spcifications

Compatibilit des navigateurs

Voir aussi

• L'objet Number auquel appartient cette mthode
• Number.MIN_SAFE_INTEGER
• Number.MAX_SAFE_INTEGER
• BigInt