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 Eigenschaft Infinity.

Eigenschaften von Number.NEGATIVE_INFINITY
Schreibbarnein
Aufzählbarnein
Konfigurierbarnein

Beschreibung

Der Wert Number.NEGATIVE_INFINITY verhält sich leicht 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 negative Null (wie in IEEE 754 definiert).
  • Jeder negative Wert, geteilt durch NEGATIVE_INFINITY, ergibt positive 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 Eigenschaft Number.NEGATIVE_INFINITY verwenden, um eine Fehlersituation anzuzeigen, die im Erfolgsfall eine endliche Zahl zurückgibt. Beachten Sie jedoch, dass in einem solchen Fall NaN angemessener wäre.

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

Beispiele

Verwendung von NEGATIVE_INFINITY

Im folgenden Beispiel wird der Variablen smallNumber ein Wert zugewiesen, der kleiner ist als der minimal mögliche Wert. Wenn die if-Anweisung ausgeführt wird, hat smallNumber den Wert -Infinity, sodass smallNumber auf einen besser handhabbaren Wert gesetzt wird, bevor fortgefahren wird.

js
let smallNumber = -Number.MAX_VALUE * 2;

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

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch