Number : propriété statique NEGATIVE_INFINITY

Exemple interactif

function checkNumber(smallNumber) {
  if (smallNumber === Number.NEGATIVE_INFINITY) {
    return "Représente le nombre comme -Infinity";
  }
  return smallNumber;
}

console.log(checkNumber(-Number.MAX_VALUE));
// Sortie attendue : -1.7976931348623157e+308

console.log(checkNumber(-Number.MAX_VALUE * 2));
// Sortie attendue : "Représente le nombre comme -Infinity"

Valeur

La même que la valeur négative de la propriété native Infinity.

Description

La valeur Number.NEGATIVE_INFINITY se comporte légèrement différemment de l'infini mathématique :

• Toute valeur positive, y compris POSITIVE_INFINITY, multipliée par NEGATIVE_INFINITY est NEGATIVE_INFINITY.
• Toute valeur négative, y compris NEGATIVE_INFINITY, multipliée par NEGATIVE_INFINITY est POSITIVE_INFINITY.
• Toute valeur positive divisée par NEGATIVE_INFINITY est un zéro négatif ^(angl.) (comme défini dans IEEE 754 ^(angl.)).
• Toute valeur négative divisée par NEGATIVE_INFINITY est un zéro positif ^(angl.) (comme défini dans IEEE 754 ^(angl.)).
• Zéro multiplié par NEGATIVE_INFINITY est NaN.
• NaN multiplié par NEGATIVE_INFINITY est NaN.
• NEGATIVE_INFINITY, divisé par toute valeur négative sauf NEGATIVE_INFINITY, est POSITIVE_INFINITY.
• NEGATIVE_INFINITY, divisé par toute valeur positive sauf POSITIVE_INFINITY, est NEGATIVE_INFINITY.
• NEGATIVE_INFINITY, divisé par soit NEGATIVE_INFINITY ou POSITIVE_INFINITY, est NaN.
• x > Number.NEGATIVE_INFINITY est vrai pour tout nombre x qui n'est pas NEGATIVE_INFINITY.

Vous pouvez utiliser la propriété Number.NEGATIVE_INFINITY pour indiquer un état d'erreur qui retourne un nombre fini en cas de succès. Notez, cependant, que NaN est plus approprié dans un tel cas.

Puisque NEGATIVE_INFINITY est une propriété statique de Number, vous l'utilisez toujours comme Number.NEGATIVE_INFINITY, plutôt que comme propriété d'une valeur numérique.

Exemples

Dans l'exemple qui suit, la variable petitNombre se voit affecter une valeur inférieure à la valeur minimale. Lorsque l'instruction if est exécutée, petitNombre a la valeur -Infinity, donc petitNombre est défini sur une valeur plus gérable avant de continuer.

let petitNombre = -Number.MAX_VALUE * 2;

if (petitNombre === Number.NEGATIVE_INFINITY) {
  petitNombre = retournerUneValeurFinie();
}

Spécifications

Compatibilité des navigateurs

Voir aussi

• La propriété statique Number.POSITIVE_INFINITY
• La méthode statique Number.isFinite()
• La valeur native Infinity
• La fonction native isFinite()