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

CKTIS / JavaScript

Number.parseFloat : analyser un préfixe décimal

Number.parseFloat convertit son argument en texte, ignore les espaces initiaux et renvoie le nombre du plus long préfixe décimal valide ou NaN.

Version : ECMAScript 2015 onward; example target: Node.js 24.22.2

Syntaxe

Number.parseFloat(string)

Number.parseFloat(value) applique d’abord ToString, retire les espaces initiaux et analyse le plus long préfixe conforme à une syntaxe décimale signée, un exposant ou le littéral Infinity. Elle s’arrête au premier caractère interdit : "12.5px" donne 12.5; si le premier caractère ne peut pas commencer un nombre, le résultat est NaN.

L’analyseur n’exige pas tout le texte et n’interprète pas les préfixes d’autres bases : Number.parseFloat("0x10") vaut 0, tandis que Number("0x10") vaut 16. Un dépassement peut donner un infini et un sous-dépassement un zéro signé. BigInt est d’abord converti en texte et peut perdre en précision dans Number ; Symbol lève TypeError et un objet peut exécuter du code de conversion.

Number.parseFloat existe depuis ECMAScript 2015, désigne la même fonction que le parseFloat global et n’est pas un constructeur. L’exemple lit volontairement le préfixe numérique de valeurs CSS mais rejette auto avec Number.isFinite. Si tout le texte doit respecter un format, validez-le séparément ou utilisez une conversion assez stricte.

Exemples

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); }

Résultat

12.5 -3 invalid
-320
0 16
true true
true

Number.parseFloat → préfixes CSS, NaN et différence avec Number

Sources