Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Number.isFinite: skończona wartość Number bez koercji

Number.isFinite zwraca true tylko dla argumentu typu Number, który nie jest NaN ani dodatnią lub ujemną nieskończonością.

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

Składnia

Number.isFinite(number)

Number.isFinite(value) najpierw sprawdza typ argumentu. Zwraca true dla każdej skończonej wartości Number, w tym +0, -0, liczb podnormalnych i Number.MAX_VALUE; zwraca false dla NaN, Infinity oraz -Infinity. Brak argumentu oznacza undefined i także daje false.

Metoda nie stosuje ToNumber. Łańcuchy, wartości boolean, null, BigInt, Symbol, zwykłe obiekty i obiekty new Number(...) dają false, a ich procedury konwersji nie są wywoływane. To ważna różnica względem globalnego isFinite, które wykonuje koercję, więc na przykład isFinite("21.25") daje true, podczas gdy Number.isFinite("21.25") daje false; globalna wersja może również rzucić podczas konwersji.

Metoda istnieje od ECMAScript 2015 i nie jest konstruktorem. Przykład używa jej na granicy walidacji temperatury, aby zaakceptować wyłącznie rzeczywistą skończoną wartość Number przed wywołaniem toFixed. Jeśli dane wejściowe mają dopuszczać tekst liczbowy, sparsuj go jawnie, a dopiero potem sprawdź wynik przez Number.isFinite.

Przykłady

function formatTemperature(value) {
  return Number.isFinite(value) ? `${value.toFixed(1)} C` : "invalid";
}

console.log([21.25, "21.25", NaN, Infinity].map(formatTemperature).join(" | "));
console.log(Number.isFinite(0), Number.isFinite(-0), Number.isFinite(Number.MAX_VALUE));
console.log(Number.isFinite(1n), Number.isFinite(Symbol("x")));
console.log(isFinite("21.25"), Number.isFinite("21.25"));

Wynik

21.3 C | invalid | invalid | invalid
true true true
false false
true false

Number.isFinite → ścisła walidacja temperatury bez koercji

Źródła