WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Number.NEGATIVE_INFINITY: negative Unendlichkeit

Number.NEGATIVE_INFINITY ist der Number-Wert -Infinity, kleiner als jede endliche Zahl und identisch mit globalem -Infinity.

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

Syntax

Number.NEGATIVE_INFINITY

Number.NEGATIVE_INFINITY ist derselbe Wert wie -Infinity und das Ergebnis von -1 / 0. Er ist kleiner als jede endliche Number und als Number.POSITIVE_INFINITY; er ist nicht die negativste endliche Zahl, nämlich -Number.MAX_VALUE. Das Lesen der Eigenschaft wirft nicht.

Unendlichkeitsarithmetik verlangt Sorgfalt: Number.NEGATIVE_INFINITY + Infinity und Number.NEGATIVE_INFINITY * 0 ergeben NaN; die Division eines endlichen Werts durch eine Unendlichkeit kann vorzeichenbehaftete null ergeben. Number.isFinite weist den Wert zurück. JSON.stringify schreibt Unendlichkeiten in Arrays und Objekteigenschaften als null und bewahrt den Sentinel daher nicht.

Die Eigenschaft existiert seit ECMAScript 1 und ist nicht schreibbar, nicht aufzählbar und nicht konfigurierbar. Das Beispiel nutzt sie als Anfangssentinel beim Maximum negativer Zahlen; eine leere Eingabe muss separat behandelt werden, da sie den Sentinel belässt. Im Strict-Code kann eine Zuweisung TypeError auslösen.

Beispiele

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);

Ergebnis

-3 true
true true
false null
false false false

Number.NEGATIVE_INFINITY → Maximum-Sentinel, leere Eingabe, Arithmetik und JSON

Quellen