Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

parseFloat — lire un nombre au début d’un texte

parseFloat convertit son argument en texte et lit le plus long préfixe valide en notation numérique décimale. Elle ignore les espaces initiaux et le texte qui suit ; si aucun nombre ne peut être lu, elle renvoie NaN.

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

Syntaxe

parseFloat(string)

parseFloat(string) est une fonction globale d’ECMAScript, et non une API de navigateur. Elle convertit d’abord son argument en texte, ignore les espaces initiaux et lit le plus long préfixe numérique valide. Elle renvoie une valeur de type Number ; Number.parseFloat désigne la même fonction.

Elle reconnaît un signe facultatif + ou -, un séparateur décimal, un exposant e ou E, ainsi que Infinity. Le texte restant est ignoré : parseFloat("12.5px") renvoie 12.5, et parseFloat("1e") renvoie 1. La virgule n’est pas un séparateur décimal : parseFloat("3,14") renvoie 3. Les préfixes hexadécimaux ne sont pas pris en charge : parseFloat("0x10") renvoie 0.

Un texte vide ou l’absence de préfixe numérique valide produit NaN. Vérifiez le résultat avec Number.isNaN(result), et non avec result === NaN. Un nombre correctement lu peut être infini ou arrondi à la précision de Number ; Number.isFinite(result) rejette NaN et les infinis.

N’utilisez pas cette fonction pour valider un champ numérique entier : elle accepte aussi "12abc". Number(string) exige que tout le texte soit valide après suppression des espaces qui l’entourent, mais convertit un texte vide en 0. parseFloat n’accepte pas d’argument de base numérique.

Exemples

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

Résultat

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

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources