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