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

CKTIS / JavaScript

Number.parseFloat: zpracování desetinného prefixu

Number.parseFloat převede argument na text, přeskočí počáteční mezery a vrátí číslo z nejdelšího platného desetinného prefixu nebo NaN.

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

Syntaxe

Number.parseFloat(string)

Number.parseFloat(value) nejprve použije ToString, odstraní počáteční bílé znaky a zpracuje nejdelší prefix odpovídající desetinné syntaxi se znaménkem, exponentu nebo literálu Infinity. Zastaví se na prvním nepovoleném znaku: "12.5px" dá 12.5; nemůže-li první znak zahájit číslo, výsledkem je NaN.

Parser nevyžaduje celý text a neinterpretuje prefixy jiných soustav: Number.parseFloat("0x10") je 0, zatímco Number("0x10") je 16. Přetečení může dát nekonečno a podtečení nulu se znaménkem. BigInt se nejprve převede na text a v Number může ztratit přesnost; Symbol vyvolá TypeError a objekt může spustit převodní kód.

Number.parseFloat existuje od ECMAScript 2015, odkazuje na stejnou funkci jako globální parseFloat a není konstruktorem. Příklad záměrně čte číselný prefix hodnot CSS, ale odmítne auto pomocí Number.isFinite. Musí-li celý text splnit formát, ověřte jej zvlášť nebo použijte dostatečně přísný převod.

Příklady

const cssWidths = ["12.5px", "-3px", "auto"];
const widths = cssWidths.map(text => {
  const value = Number.parseFloat(text);
  return Number.isFinite(value) ? value : "invalid";
});
console.log(widths.join(" "));
console.log(Number.parseFloat("  -3.2e2rest"));
console.log(Number.parseFloat("0x10"), Number("0x10"));
console.log(Number.isNaN(Number.parseFloat("auto")), Number.parseFloat === parseFloat);
try { Number.parseFloat(Symbol("x")); } catch (error) { console.log(error instanceof TypeError); }

Výsledek

12.5 -3 invalid
-320
0 16
true true
true

Number.parseFloat → prefixy CSS, NaN a rozdíl oproti Number

Zdroje