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.

Die statische Dateneigenschaft Number.NEGATIVE_INFINITY repräsentiert den negativen Unendlichkeitswert.

Probieren Sie es aus

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"

Wert

Entspricht dem negativen Wert der globalen Infinity-Eigenschaft.

Eigenschaften von `Number.NEGATIVE_INFINITY`
Schreibbar	nein
Aufzählbar	nein
Konfigurierbar	nein

Beschreibung

Der Number.NEGATIVE_INFINITY-Wert verhält sich etwas anders als die mathematische Unendlichkeit:

Jeder positive Wert, einschließlich POSITIVE_INFINITY, multipliziert mit NEGATIVE_INFINITY ergibt NEGATIVE_INFINITY.
Jeder negative Wert, einschließlich NEGATIVE_INFINITY, multipliziert mit NEGATIVE_INFINITY ergibt POSITIVE_INFINITY.
Jeder positive Wert, geteilt durch NEGATIVE_INFINITY, ergibt negatives Null (wie in IEEE 754 definiert).
Jeder negative Wert, geteilt durch NEGATIVE_INFINITY, ergibt positives Null (wie in IEEE 754 definiert).
Null multipliziert mit NEGATIVE_INFINITY ergibt NaN.
NaN multipliziert mit NEGATIVE_INFINITY ergibt NaN.
NEGATIVE_INFINITY, geteilt durch jeden negativen Wert außer NEGATIVE_INFINITY, ergibt POSITIVE_INFINITY.
NEGATIVE_INFINITY, geteilt durch jeden positiven Wert außer POSITIVE_INFINITY, ergibt NEGATIVE_INFINITY.
NEGATIVE_INFINITY, geteilt durch entweder NEGATIVE_INFINITY oder POSITIVE_INFINITY, ergibt NaN.
x > Number.NEGATIVE_INFINITY ist wahr für jede Zahl x, die nicht NEGATIVE_INFINITY ist.

Sie könnten die Number.NEGATIVE_INFINITY-Eigenschaft verwenden, um einen Fehlerzustand anzuzeigen, der im Erfolgsfall eine endliche Zahl zurückgibt. Beachten Sie jedoch, dass NaN in einem solchen Fall geeigneter wäre.

Da NEGATIVE_INFINITY eine statische Eigenschaft von Number ist, verwenden Sie es immer als Number.NEGATIVE_INFINITY und nicht als Eigenschaft eines Zahlenwerts.

Beispiele

Verwendung von NEGATIVE_INFINITY

Im folgenden Beispiel wird der Variable smallNumber ein Wert zugewiesen, der kleiner ist als der Minimalwert. Wenn die if-Anweisung ausgeführt wird, hat smallNumber den Wert -Infinity, sodass smallNumber auf einen handlicheren Wert gesetzt wird, bevor es weitergeht.

let smallNumber = -Number.MAX_VALUE * 2;

if (smallNumber === Number.NEGATIVE_INFINITY) {
  smallNumber = returnFinite();
}

Spezifikationen

Specification
ECMAScript® 2026 Language Specification # sec-number.negative_infinity