CKTIS / JavaScript
Number.prototype.toExponential : notation exponentielle
toExponential renvoie un texte exponentiel avec un chiffre avant le point et le nombre demandé après celui-ci.
Version : ECMAScript 3 onward; example target: Node.js 24.22.2
Syntaxe
number.toExponential(fractionDigits)number.toExponential(fractionDigits) formate un Number en texte décimal avec un e minuscule, un signe d’exposant explicite et un chiffre avant le point. Si fractionDigits vaut undefined, la méthode choisit la plus courte suite identifiant le Number sans ambiguïté. S’il est fourni, le résultat contient exactement ce nombre de chiffres après le point.
L’argument passe par ToIntegerOrInfinity : les fractions sont tronquées vers zéro et NaN devient 0. Pour un récepteur fini, la plage est 0..100 ; hors plage et ±Infinity lèvent RangeError. Mais l’argument est converti d’abord, puis un récepteur non fini renvoie son texte avant la validation de plage : Infinity.toExponential(101) donne donc "Infinity" ; un objet argument peut encore lever pendant sa conversion.
La méthode existe depuis ECMAScript 3, n’est pas générique et lève TypeError si le récepteur n’est ni un Number ni un Number encapsulé. Elle arrondit au résultat mathématique le plus proche et, à égalité après séparation du signe, choisit la plus grande magnitude ; la représentation binaire peut surprendre. Le zéro négatif est écrit sans signe moins.
Exemples
console.log((1234.5).toExponential(2), (0.00125).toExponential(2));
console.log((7).toExponential(), (-0).toExponential(1));
console.log(Infinity.toExponential(101));
try { console.log((1).toExponential(101)); } catch (error) { console.log(error.name); }
try { Number.prototype.toExponential.call("1", 2); } catch (error) { console.log(error.name); }Résultat
1.23e+3 1.25e-3 7e+0 0.0e+0 Infinity RangeError TypeError
L’exemple montre les chiffres imposés, l’argument omis, -0 et l’ordre Infinity/RangeError.