Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Number.NEGATIVE_INFINITY: ujemna nieskończoność

Number.NEGATIVE_INFINITY jest wartością Number -Infinity, mniejszą od każdej skończonej liczby i równą globalnemu -Infinity.

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

Składnia

Number.NEGATIVE_INFINITY

Number.NEGATIVE_INFINITY jest tą samą wartością co -Infinity i wynik -1 / 0. Jest mniejsza od każdej skończonej wartości Number oraz od Number.POSITIVE_INFINITY; nie jest jednak najbardziej ujemną skończoną liczbą, którą jest -Number.MAX_VALUE. Odczyt właściwości nie rzuca wyjątku.

Arytmetyka z nieskończonością wymaga uwagi: Number.NEGATIVE_INFINITY + Infinity oraz Number.NEGATIVE_INFINITY * 0 dają NaN, a dzielenie skończonej wartości przez nieskończoność może dać znakowane zero. Number.isFinite odrzuca tę wartość. JSON.stringify zapisuje nieskończoności w tablicach i właściwościach obiektów jako null, więc nie zachowuje sentinela.

Właściwość istnieje od ECMAScript 1 i jest niewritable, nieenumerowalna oraz niekonfigurowalna. Przykład używa jej jako początkowego sentinela podczas szukania maksimum liczb ujemnych; pusty zbiór trzeba rozpoznać osobno, bo pozostawia sentinel. W kodzie strict próba przypisania do właściwości może rzucić TypeError.

Przykłady

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

Wynik

-3 true
true true
false null
false false false

Number.NEGATIVE_INFINITY → sentinel maksimum, pusty zbiór, arytmetyka i JSON

Źródła