Number.NEGATIVE_INFINITY

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

La propriété Number.NEGATIVE_INFINITY représente l'infini négatif.

Exemple interactif

Attributs de Number.NEGATIVE_INFINITY
ÉcrivableNon
ÉnumérableNon
ConfigurableNon

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é.

js
var petitNombre = -Number.MAX_VALUE * 2;

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

Spécifications

Specification
ECMAScript Language Specification
# sec-number.negative_infinity

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi