Number.NEGATIVE_INFINITY

Exemple interactif

function checkNumber(smallNumber) {
  if (smallNumber === Number.NEGATIVE_INFINITY) {
    return "Process number as -Infinity";
  }
  return smallNumber;
}

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

console.log(checkNumber(-Number.MAX_VALUE * 2));
// Expected output: "Process number as -Infinity"

Description

La valeur de Number.NEGATIVE_INFINITY est égale à l'opposé de la valeur fournie par la propriété Infinity de l'objet global.

Cette valeur se comporte différemment de l'infini mathématique :

• Toute valeur positive, y compris POSITIVE_INFINITY, multipliée par NEGATIVE_INFINITY sera égale à NEGATIVE_INFINITY.
• Toute valeur négative, y compris NEGATIVE_INFINITY, multipliée par NEGATIVE_INFINITY sera égale à POSITIVE_INFINITY.
• Zéro multiplié par NEGATIVE_INFINITY sera égal à NaN.
• NaN multiplié par NEGATIVE_INFINITY sera égal à NaN.
• NEGATIVE_INFINITY, divisé par n'importe quelle valeur négative, à l'exception de NEGATIVE_INFINITY, sera égal à POSITIVE_INFINITY.
• NEGATIVE_INFINITY, divisé par n'importe quelle valeur positive à l'exception de POSITIVE_INFINITY, sera égal à NEGATIVE_INFINITY.
• NEGATIVE_INFINITY, divisé par NEGATIVE_INFINITY ou POSITIVE_INFINITY, sera égal à NaN.
• Tout nombre positif divisé par NEGATIVE_INFINITY sera égal au zéro négatif.
• Tout nombre négatif divisé par NEGATIVE_INFINITY sera égal au zéro positif.

La propriété Number.NEGATIVE_INFINITY peut être utilisée pour indiquer une erreur sur un test renvoyant normalement un nombre fini. On notera cependant que la méthode isFinite est plus pertinente dans ce cas.

Number.NEGATIVE_INFINITY est une propriété statique de Number et on utilisera directement Number.NEGATIVE_INFINITY plutôt que comme une propriété d'un objet (instance) Number.

Exemples

Dans l'exemple qui suit, on affecte une variable inférieure à la valeur numérique minimale à la variable petitNombre. Lorsque l'instruction conditionnelle if est exécutée, petitNombre possède la valeur "-Infinity", on modifie donc la valeur de petitNombre afin qu'il puisse être géré.

var petitNombre = -Number.MAX_VALUE * 2;

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

Spécifications

Compatibilité des navigateurs

Voir aussi

• Number.POSITIVE_INFINITY
• Number.isFinite()
• Infinity
• isFinite()