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