CKTIS / JavaScript
Number.parseFloat: analisar um prefixo decimal
Number.parseFloat converte o argumento para texto, ignora espaços iniciais e devolve o número do prefixo decimal válido mais longo ou NaN.
Versão: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintaxe
Number.parseFloat(string)Number.parseFloat(value) aplica primeiro ToString, remove espaços iniciais e analisa o prefixo mais longo que corresponda a sintaxe decimal com sinal, expoente ou ao literal Infinity. Para no primeiro carácter proibido: "12.5px" dá 12.5; se o primeiro não puder iniciar um número, o resultado é NaN.
O parser não exige todo o texto nem interpreta prefixos de outras bases: Number.parseFloat("0x10") é 0, enquanto Number("0x10") é 16. Overflow pode dar infinito e underflow zero com sinal. BigInt é primeiro convertido para texto e pode perder precisão em Number; Symbol lança TypeError e um objeto pode executar código de conversão.
Number.parseFloat existe desde ECMAScript 2015, referencia a mesma função que parseFloat global e não é construtor. O exemplo lê deliberadamente o prefixo numérico de valores CSS, mas rejeita auto com Number.isFinite. Se todo o texto tiver de cumprir um formato, valida-o separadamente ou usa uma conversão suficientemente estrita.
Exemplos
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); }Resultado
12.5 -3 invalid -320 0 16 true true true
Number.parseFloat → prefixos CSS, NaN e diferença face a Number