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

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.

Sources