Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes