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

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.

Sources