Number.NEGATIVE_INFINITY

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

Attributs de Number.NEGATIVE_INFINITY
Écrivable Non
Énumérable Non
Configurable Non

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

Spécification État Commentaires
ECMAScript 1st Edition (ECMA-262) Standard Définition initiale. Implémentée avec JavaScript 1.1.
ECMAScript 5.1 (ECMA-262)
La définition de 'Number.NEGATIVE_INFINITY' dans cette spécification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'Number.NEGATIVE_INFINITY' dans cette spécification.
Standard  
ECMAScript Latest Draft (ECMA-262)
La définition de 'Number.NEGATIVE_INFINITY' dans cette spécification.
Projet  

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobileServeur
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung InternetNode.js
NEGATIVE_INFINITYChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 4Opera Support complet OuiSafari Support complet OuiWebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet 1.0nodejs Support complet Oui

Légende

Support complet  
Support complet

Voir aussi