Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła