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

CKTIS / JavaScript

parseFloat — ler um número no início de um texto

parseFloat converte o seu argumento em texto e lê o prefixo válido mais longo em notação numérica decimal. Ignora os espaços em branco iniciais e o texto seguinte; se não conseguir ler um número, devolve NaN.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

parseFloat(string)

parseFloat(string) é uma função global de ECMAScript, não uma API do browser. Primeiro converte o seu argumento em texto, ignora os espaços em branco iniciais e lê o prefixo numérico válido mais longo. Devolve um valor do tipo Number; Number.parseFloat refere-se à mesma função.

Reconhece um sinal opcional + ou -, um ponto decimal, um expoente e ou E e Infinity. O texto restante é ignorado: parseFloat("12.5px") devolve 12.5 e parseFloat("1e") devolve 1. A vírgula não é um separador decimal: parseFloat("3,14") devolve 3. Os prefixos hexadecimais não são suportados: parseFloat("0x10") devolve 0.

Um texto vazio ou a ausência de um prefixo numérico válido produz NaN. Verifique o resultado com Number.isNaN(result), não com result === NaN. Um número lido corretamente pode ser infinito ou arredondado à precisão de Number; Number.isFinite(result) rejeita tanto NaN como os infinitos.

Não utilize esta função para validar um campo numérico completo: também aceita "12abc". Number(string) exige que todo o texto seja válido depois de ignorar os espaços em branco à sua volta, mas converte o texto vazio em 0. parseFloat não aceita um argumento de base numérica.

Exemplos

const inputs = ["  -12.5px", "1.25e2kg", "3,14", "0x10", "abc", ""];
for (const input of inputs) {
  console.log(`${JSON.stringify(input)} => ${parseFloat(input)}`);
}

Resultado

"  -12.5px" => -12.5
"1.25e2kg" => 125
"3,14" => 3
"0x10" => 0
"abc" => NaN
"" => NaN

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes