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

CKTIS / JavaScript

Number.isFinite: konečná hodnota Number bez koerce

Number.isFinite vrátí true pouze tehdy, když je argument typu Number a není NaN ani kladné či záporné nekonečno.

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

Syntaxe

Number.isFinite(number)

Number.isFinite(value) nejprve zkontroluje typ argumentu. Pro každou konečnou hodnotu Number, včetně +0, -0, subnormálních čísel a Number.MAX_VALUE, vrátí true; pro NaN, Infinity a -Infinity vrátí false. Chybějící argument je undefined a také dává false.

Metoda nepoužívá ToNumber. Řetězce, booleovské hodnoty, null, BigInt, Symbol, běžné objekty a obalové objekty new Number(...) dají false a jejich převodní mechanismy se nespustí. Tím se liší od globálního isFinite, které převádí: například isFinite("21.25") je true, zatímco Number.isFinite("21.25") je false; globální forma může při převodu také vyhodit výjimku.

Metoda existuje od ECMAScript 2015 a není konstruktorem. Příklad ji používá na hranici validace teploty, aby se toFixed volalo jen nad skutečnou konečnou hodnotou Number. Má-li být povolen číselný text, explicitně jej zpracujte a výsledek pak ověřte pomocí Number.isFinite.

Příklady

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"));

Výsledek

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

Number.isFinite → přísná validace teploty bez koerce

Zdroje