Number.NEGATIVE_INFINITY

Die Number.NEGATIVE_INFINITY Eigenschaft repräsentiert den Wert der negativen Unendlichkeit.

Man muss kein Objekt vom Typ Number erzeugen, um Zugriff zu haben, weil diese Eigenschaft statisch ist (nutze  Number.NEGATIVE_INFINITY).

Eigenschaftsattribute von Number.NEGATIVE_INFINITY
Schreibbar nein
Aufzählbar nein
Konfigurierbar nein

Beschreibung

Der Wert von Number.NEGATIVE_INFINITY ist der gleiche wie der negative Wert der Eigenschaft Infinity des globalen Objektes.

Der Wert verhält sich leicht unterschiedlich zu der mathematischen Unendlichkeit:

  • Jeder positive Wert, auch POSITIVE_INFINITY, multipliziert mit NEGATIVE_INFINITY ergibt NEGATIVE_INFINITY.
  • Jeder negative Wert, auch NEGATIVE_INFINITY, multipliziert mit  NEGATIVE_INFINITY ergibt POSITIVE_INFINITY.
  • Jeder positive Wert dividiert durch NEGATIVE_INFINITY ergibt 0.
  • Jeder negative Wert dividiert durch NEGATIVE_INFINITY ergibt 0.
  • 0 multipliziert mit NEGATIVE_INFINITY ergibt NaN.
  • NaN multipliziert mit NEGATIVE_INFINITY ergibt NaN.
  • NEGATIVE_INFINITY dividiert durch jeden negativen Wert, mit Ausnahme von NEGATIVE_INFINITY, ergibt POSITIVE_INFINITY.
  • NEGATIVE_INFINITY dividiert durch jeden positiven Wert, mit Ausnahme von POSITIVE_INFINITY, ergibt NEGATIVE_INFINITY.
  • NEGATIVE_INFINITY dividiert durch NEGATIVE_INFINITY oder POSITIVE_INFINITY ergibt NaN.

Man kann Number.NEGATIVE_INFINITY nutzen, um einen Fehlerfall zu signalisieren, wenn im Normalfall ein endliches Ergebnis erwartet werden kann. Zudem kann ein Wert mit isFinite auf seine Endlichkeit geprüft werden.

Beispiele

Einsatz von NEGATIVE_INFINITY

Im folgenden Beispiel wird der Variablen smallNumber ein kleinerer Wert als der minimale Wert zugewiesen. Wenn das if-Statement ausgeführt wird, hat smallNumber den Wert -Infinity. In diesem Fall wird der Variablen ein endlicher Wert zugewiesen, um mit dem Wert besser umgehen zu können.

var smallNumber = (-Number.MAX_VALUE) * 2;

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

Spezifikationen

Spezifikation Status Kommentar
ECMAScript 1st Edition (ECMA-262) Standard Initiale Definition. Implementiert in JavaScript 1.1.
ECMAScript 5.1 (ECMA-262)
Die Definition von 'Number.NEGATIVE_INFINITY' in dieser Spezifikation.		 Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
Die Definition von 'Number.NEGATIVE_INFINITY' in dieser Spezifikation.		 Standard  
ECMAScript Latest Draft (ECMA-262)
Die Definition von 'Number.NEGATIVE_INFINITY' in dieser Spezifikation.		 Entwurf  

Browserkompatibilität

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid WebviewChrome für AndroidFirefox für AndroidOpera für AndroidSafari auf iOSSamsung InternetNode.js
NEGATIVE_INFINITYChrome Vollständige Unterstützung 1Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 1IE Vollständige Unterstützung 4Opera Vollständige Unterstützung JaSafari Vollständige Unterstützung 1WebView Android Vollständige Unterstützung 1Chrome Android Vollständige Unterstützung 18Firefox Android Vollständige Unterstützung 4Opera Android Vollständige Unterstützung JaSafari iOS Vollständige Unterstützung 1Samsung Internet Android Vollständige Unterstützung 1.0nodejs Vollständige Unterstützung Ja

Legende

Vollständige Unterstützung  
Vollständige Unterstützung

Siehe auch

Verwandte Themen
  1. Standard-Objekte
  2. Number
  3. Eigenschaften
    1. Number.EPSILON
    2. Number.MAX_SAFE_INTEGER
    3. Number.MAX_VALUE
    4. Number.MIN_SAFE_INTEGER
    5. Number.MIN_VALUE
    6. Number.NEGATIVE_INFINITY
    7. Number.NaN
    8. Number.POSITIVE_INFINITY
    9. Number.prototype
  4. Methoden
    1. Number.isFinite()
    2. Number.isInteger()
    3. Number.isNaN()
    4. Number.isSafeInteger()
    5. Number.parseFloat()
    6. Number.parseInt()
    7. Number.prototype.toExponential()
    8. Number.prototype.toFixed()
    9. Number.prototype.toLocaleString()
    10. Number.prototype.toPrecision()
    11. Number.prototype.toSource()
    12. Number.prototype.toString()
    13. Number.prototype.valueOf()
    14. Number.toInteger()
  5. Vererbung:
  6. Function
  7. Eigenschaften
    1. Function.arguments
    2. Function.arity
    3. Function.caller
    4. Function.displayName
    5. Function.length
    6. Function.name
    7. Function.prototype
  8. Methoden
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.isGenerator()
    5. Function.prototype.toSource()
    6. Function.prototype.toString()
  9. Object
  10. Eigenschaften
    1. Object.prototype.__count__ [Übersetzen]
    2. Object.prototype.__noSuchMethod__ [Übersetzen]
    3. Object.prototype.__parent__ [Übersetzen]
    4. Object.prototype.__proto__
    5. Object.prototype.constructor
  11. Methoden
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__() [Übersetzen]
    3. Object.prototype.__lookupGetter__() [Übersetzen]
    4. Object.prototype.__lookupSetter__() [Übersetzen]
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf() [Übersetzen]
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString() [Übersetzen]
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.unwatch() [Übersetzen]
    12. Object.prototype.valueOf()
    13. Object.prototype.watch() [Übersetzen]
    14. Object.setPrototypeOf() [Übersetzen]