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

CKTIS / JavaScript

Number.prototype.toFixed : décimales fixes

toFixed renvoie un texte en notation fixe avec exactement le nombre demandé de chiffres après le point.

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

Syntaxe

number.toFixed(fractionDigits)

number.toFixed(fractionDigits) renvoie un texte avec exactement fractionDigits chiffres après le point ; sans argument, la valeur est 0. L’argument passe par ToIntegerOrInfinity : une fraction est tronquée vers zéro, NaN devient 0 et -0.5 mène aussi à zéro. La plage 0..100 est vérifiée avant les valeurs non finies, donc même Infinity.toFixed(101) lève RangeError.

Avec un nombre de chiffres valide, NaN et ±Infinity renvoient "NaN" et le texte d’infini correspondant. Si la valeur absolue atteint 10**21, la méthode utilise ToString ordinaire sans ajouter de décimales fixes. Sinon elle choisit le résultat le plus proche et, à égalité après séparation du signe, la plus grande magnitude. Number étant binaire, (2.55).toFixed(1) donne "2.5" ; le zéro négatif perd son signe, mais une petite valeur négative arrondie à zéro peut donner "-0.00".

La méthode existe depuis ECMAScript 3, n’est pas générique et lève TypeError pour un récepteur autre qu’un Number ou Number encapsulé. Elle renvoie du texte, pas un nombre, sans format local. Pour l’argent, toFixed ne supprime pas l’erreur binaire ; stocke la plus petite unité comme entier ou utilise un type décimal adapté.

Exemples

console.log((12.375).toFixed(2), (2.55).toFixed(1));
console.log((-0).toFixed(2), (-0.0001).toFixed(2));
console.log((1e21).toFixed(2), Infinity.toFixed(2));
try { console.log(Infinity.toFixed(101)); } catch (error) { console.log(error.name); }
try { Number.prototype.toFixed.call("1", 2); } catch (error) { console.log(error.name); }

Résultat

12.38 2.5
0.00 -0.00
1e+21 Infinity
RangeError
TypeError

L’exemple montre arrondi, surprise binaire, -0, seuil 10**21 et RangeError avec Infinity.

Sources