CKTIS / JavaScript
parseFloat — odczytywanie liczby z początku tekstu
parseFloat przekształca argument w tekst i odczytuje jego najdłuższy poprawny początek w dziesiętnym zapisie liczby. Ignoruje początkowe białe znaki i końcowy tekst; gdy nie znajduje liczby, zwraca NaN.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
parseFloat(string)parseFloat(string) to globalna funkcja ECMAScript, nie API przeglądarki. Najpierw przekształca argument w tekst, pomija początkowe białe znaki i odczytuje najdłuższy poprawny prefiks liczbowy. Zwraca wartość typu Number; Number.parseFloat wskazuje tę samą funkcję.
Rozpoznaje opcjonalny znak + lub -, kropkę dziesiętną, wykładnik e lub E oraz Infinity. Pozostała część tekstu jest ignorowana: parseFloat("12.5px") daje 12.5, a parseFloat("1e") daje 1. Przecinek nie jest separatorem dziesiętnym: parseFloat("3,14") daje 3. Prefiks szesnastkowy nie jest obsługiwany: parseFloat("0x10") daje 0.
Pusty tekst lub brak poprawnego początku liczbowego daje NaN. Wynik sprawdzaj przez Number.isNaN(result), nie przez result === NaN. Poprawnie odczytana liczba może być nieskończona lub zaokrąglona do precyzji typu Number; Number.isFinite(result) odrzuca zarówno NaN, jak i nieskończoności.
Nie używaj tej funkcji do sprawdzania poprawności całego pola liczbowego: zaakceptuje także "12abc". Number(string) wymaga poprawności całego tekstu po pominięciu otaczających białych znaków, ale pusty tekst zamienia na 0. parseFloat nie przyjmuje argumentu podstawy systemu liczbowego.
Przykłady
const inputs = [" -12.5px", "1.25e2kg", "3,14", "0x10", "abc", ""];
for (const input of inputs) {
console.log(`${JSON.stringify(input)} => ${parseFloat(input)}`);
}Wynik
" -12.5px" => -12.5 "1.25e2kg" => 125 "3,14" => 3 "0x10" => 0 "abc" => NaN "" => NaN
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.