Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Number.parseFloat: parsowanie dziesiętnego prefiksu

Number.parseFloat konwertuje argument do tekstu, pomija początkowe białe znaki i zwraca liczbę z najdłuższego poprawnego dziesiętnego prefiksu albo NaN.

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

Składnia

Number.parseFloat(string)

Number.parseFloat(value) najpierw stosuje ToString, usuwa początkowe białe znaki i parsuje najdłuższy prefiks zgodny z podpisaną składnią dziesiętną, wykładnikiem lub dosłownym Infinity. Kończy na pierwszym niedozwolonym znaku, więc "12.5px" daje 12.5, a gdy pierwszy znak nie rozpoczyna liczby, wynikiem jest NaN.

Parser nie wymaga zużycia całego tekstu i nie interpretuje prefiksów innych podstaw: Number.parseFloat("0x10") daje 0, choć Number("0x10") daje 16. Przepełnienie może dać nieskończoność, a podpełnienie znakowane zero. BigInt jest najpierw zamieniany na tekst i może utracić precyzję w Number; Symbol powoduje TypeError, a obiekt może uruchomić kod konwersji.

Właściwość Number.parseFloat istnieje od ECMAScript 2015, wskazuje tę samą funkcję co globalne parseFloat i nie jest konstruktorem. Przykład celowo odczytuje liczbowy prefiks wartości CSS, ale odrzuca auto przez Number.isFinite. Jeśli cały tekst musi spełniać format, zwaliduj go osobno albo użyj odpowiednio ścisłej konwersji zamiast polegać na zatrzymaniu parsera.

Przykłady

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

Wynik

12.5 -3 invalid
-320
0 16
true true
true

Number.parseFloat → prefiksy wartości CSS, NaN i różnica względem Number

Źródła