Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

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

Number.isFinite vráti true iba vtedy, keď je argument typu Number a nie je NaN ani kladné či záporné nekonečno.

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

Syntax

Number.isFinite(number)

Number.isFinite(value) najprv skontroluje typ argumentu. Pre každú konečnú hodnotu Number vrátane +0, -0, subnormálnych čísel a Number.MAX_VALUE vráti true; pre NaN, Infinity a -Infinity vráti false. Chýbajúci argument je undefined a tiež dá false.

Metóda nepoužíva ToNumber. Reťazce, boolean hodnoty, null, BigInt, Symbol, bežné objekty a obalové objekty new Number(...) dajú false a ich prevodné mechanizmy sa nespustia. Tým sa líši od globálneho isFinite, ktoré konvertuje: napríklad isFinite("21.25") je true, zatiaľ čo Number.isFinite("21.25") je false; globálna forma môže pri prevode aj vyhodiť výnimku.

Metóda existuje od ECMAScript 2015 a nie je konštruktorom. Príklad ju používa na hranici validácie teploty, aby sa toFixed volalo iba nad skutočnou konečnou hodnotou Number. Ak má byť povolený číselný text, explicitne ho spracujte a výsledok potom overte pomocou Number.isFinite.

Prí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ýsledok

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

Number.isFinite → prísna validácia teploty bez koercie

Zdroje