Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Number.NEGATIVE_INFINITY : infini négatif

Number.NEGATIVE_INFINITY est la valeur Number -Infinity, inférieure à tout nombre fini et identique au -Infinity global.

Version : ECMAScript 1 onward; example target: Node.js 24.22.2

Syntaxe

Number.NEGATIVE_INFINITY

Number.NEGATIVE_INFINITY est la même valeur que -Infinity et le résultat de -1 / 0. Elle est inférieure à tout Number fini ainsi qu’à Number.POSITIVE_INFINITY ; ce n’est pas le nombre fini le plus négatif, qui est -Number.MAX_VALUE. Lire la propriété ne lève rien.

L’arithmétique des infinis demande de la prudence : Number.NEGATIVE_INFINITY + Infinity et Number.NEGATIVE_INFINITY * 0 donnent NaN, tandis que diviser une valeur finie par un infini peut donner un zéro signé. Number.isFinite rejette cette valeur. JSON.stringify écrit les infinis des tableaux et propriétés comme null et ne conserve donc pas le sentinelle.

La propriété existe depuis ECMAScript 1 et n’est ni modifiable, ni énumérable, ni configurable. L’exemple l’utilise comme sentinelle initiale pour chercher le maximum de nombres négatifs ; une entrée vide doit être traitée séparément, car elle laisse la sentinelle. En mode strict, une affectation peut lever TypeError.

Exemples

function maximum(values) {
  let result = Number.NEGATIVE_INFINITY;
  for (const value of values) {
    if (value > result) result = value;
  }
  return result;
}

console.log(maximum([-8, -3, -11]), maximum([]) === Number.NEGATIVE_INFINITY);
console.log(Number.NEGATIVE_INFINITY === -Infinity, Number.NEGATIVE_INFINITY === -1 / 0);
console.log(Number.isFinite(Number.NEGATIVE_INFINITY), JSON.stringify(Number.NEGATIVE_INFINITY));
const descriptor = Object.getOwnPropertyDescriptor(Number, "NEGATIVE_INFINITY");
console.log(descriptor.writable, descriptor.enumerable, descriptor.configurable);

Résultat

-3 true
true true
false null
false false false

Number.NEGATIVE_INFINITY → sentinelle de maximum, entrée vide, arithmétique et JSON

Sources