CKTIS / JavaScript
Number.prototype.toPrecision : chiffres significatifs
toPrecision renvoie un texte avec le nombre demandé de chiffres significatifs, en notation fixe ou exponentielle.
Version : ECMAScript 3 onward; example target: Node.js 24.22.2
Syntaxe
number.toPrecision(precision)number.toPrecision(precision) formate la valeur avec precision chiffres significatifs. Si l’argument est absent ou vaut undefined, la méthode renvoie immédiatement le résultat ToString ordinaire du nombre. Un argument fourni passe par ToIntegerOrInfinity : la fraction est tronquée vers zéro et NaN devient 0 ; pour un récepteur fini, un résultat hors de 1..100 lève RangeError.
Après conversion d’un argument fourni, un récepteur NaN ou ±Infinity renvoie son texte ordinaire avant le contrôle de plage ; Infinity.toPrecision(0) donne donc "Infinity". Un objet donné comme precision peut néanmoins lever une exception pendant sa conversion. Pour une valeur finie, la notation exponentielle est employée si l’exposant décimal est inférieur à -6 ou au moins égal à precision, sinon la notation fixe est employée. L’arrondi choisit le résultat le plus proche et, à égalité après séparation du signe, la plus grande magnitude.
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. Number étant binaire, l’arrondi peut surprendre ; utilise Intl.NumberFormat pour une présentation locale.
Exemples
console.log((1234.5).toPrecision(4), (1234.5).toPrecision(3));
console.log((0.0000012345).toPrecision(3), (0.00000012345).toPrecision(3));
console.log((7).toPrecision(), (-0).toPrecision(3));
console.log(Infinity.toPrecision(0));
try { console.log((1).toPrecision(0)); } catch (error) { console.log(error.name); }
try { Number.prototype.toPrecision.call("1", 2); } catch (error) { console.log(error.name); }Résultat
1235 1.23e+3 0.00000123 1.23e-7 7 0.00 Infinity RangeError TypeError
L’exemple compare les notations fixe et exponentielle et montre -0, Infinity et les erreurs de plage/récepteur.