Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

isFinite() — konečnost po číselné konverzi

Globální funkce isFinite(value) ověřuje, zda se její argument po konverzi změní na konečné číslo. Na rozdíl od Number.isFinite() přijímá díky konverzi také některé hodnoty jiných typů, například "42" a null.

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

Syntaxe

isFinite(value)

isFinite(value) je globální funkce ECMAScriptu. Nejprve převede argument na Number pomocí operace ToNumber a poté vrátí true, pokud je výsledek konečný. Pro NaN, Infinity a -Infinity vrátí false; obě nuly a konečné zlomky dávají true.

Na konverzi záleží: "42" se změní na 42, zatímco "" a null se změní na 0, takže všechny tyto argumenty dávají true. undefined a řetězec "hello" se změní na NaN a dávají false. Volání isFinite() bez argumentu také vrátí false.

Nejde o přísnou kontrolu číselného typu. Chcete-li ověřit, zda je hodnota již konečným číslem typu Number, použijte Number.isFinite(value): neprovádí konverzi a vrací false pro "42", null i všechny ostatní hodnoty, které nejsou typu Number. Konečnost neznamená, že je číslo celé nebo bezpečné celé číslo.

Konverze může také vyvolat výjimku: argument typu Symbol nebo BigInt způsobí TypeError místo vrácení false. U objektů může konverze spustit vlastní kód a předat dál vzniklou výjimku. Příklad porovnává obě kontroly, aniž používá objekty nebo hodnoty, které vyvolávají výjimku.

Příklady

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

Výsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje