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

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"
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® 2025 Language Specification
# sec-number.negative_infinity

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
NEGATIVE_INFINITY

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Voir aussi