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

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

Siehe auch