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.