Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

isFinite() — skończoność po konwersji na liczbę

Globalna funkcja isFinite(value) sprawdza, czy argument po konwersji na Number jest liczbą skończoną. W odróżnieniu od Number.isFinite() akceptuje przez konwersję także niektóre wartości innych typów, na przykład "42" i null.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

isFinite(value)

isFinite(value) to globalna funkcja ECMAScript. Najpierw konwertuje argument na Number za pomocą operacji ToNumber, a następnie zwraca true, jeśli wynik jest skończony. Dla NaN, Infinity i -Infinity zwraca false; oba zera i skończone ułamki dają true.

Konwersja ma znaczenie: "42" staje się 42, a "" i null stają się 0, więc wszystkie te argumenty dają true. undefined oraz tekst "hello" stają się NaN i dają false. Wywołanie isFinite() bez argumentu również daje false.

Nie jest to ścisły test typu liczbowego. Do sprawdzania, czy wartość już jest skończoną liczbą typu Number, użyj Number.isFinite(value): nie wykonuje konwersji i zwraca false dla "42", null oraz wszystkich innych wartości spoza typu Number. Skończoność nie oznacza, że liczba jest całkowita lub jest bezpieczną liczbą całkowitą.

Konwersja może też zgłosić wyjątek: argument typu Symbol lub BigInt powoduje TypeError, zamiast wyniku false. Dla obiektów konwersja może uruchomić własny kod i przekazać dalej zgłoszony wyjątek. Przykład porównuje oba testy bez używania obiektów ani wartości powodujących wyjątek.

Przykłady

const values = [42, "42", "", null, NaN, Infinity, undefined];
for (const value of values) {
  console.log(`${isFinite(value)} | ${Number.isFinite(value)}`);
}

Wynik

true | true
true | false
true | false
true | false
false | false
false | false
false | false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła