Number.prototype.toExponential()

La méthode toExponential() renvoie une chaîne de caractères, représentant l'objet Number en notation exponentielle.

Syntaxe

numObj.toExponential([nbChiffresDécimaux])

Paramètre

nbChiffresDécimaux
Paramètre optionnel. Un entier donnant le nombre de chiffres qu'on souhaite avoir dans la partie fractionnaire. Le comportement par défaut considèrera autant de chiffres que nécessaire pour représenter le nombre.

Valeur de retour

Une chaîne représentant l'objet Number appelant en notation exponentielle avec un chiffre avant la virgule et arrondi à nbChiffresDécimaux après la virgule.

Exceptions

RangeError
Cette exception est causée si nbChiffresDécimaux est trop petit ou trop grand. Les valeurs comprises, au sens large, entre 0 et 20 ne causeront pas d'exception RangeError. Les implémentations peuvent également autorisér des valeurs en dehors de ces bornes.
TypeError
Si cette méthode est invoquée pour un objet qui n'est pas un objet Number.

Description

La valeur renvoyée est une chaîne de caractères correspondant à la représentation du nombre en notation exponentielle. La partie entière est constituée d'un seul chiffre et la partie fractionnaire est composée de nbChiffresDécimaux chiffres. Si l'argument nbChiffresDécimaux est absent, il y aura autant de chiffres dans la partie fractionnaire que nécessaire pour représenter le nombre de façon unique.

Si la méthode toExponential() est utilisée avec un littéral numérique et que celui-ci ne possède aucun exposant ou séparateur décimal ("."), il faut laisser un ou plusieurs espaces entre le littéral et le point indiquant l'appel de la méthode. Cela permet d'éviter que le point, permettant d'accéder à la méthode, soit confondu avec un séparateur décimal.

Si un nombre possède plus de chiffres décimaux que nbChiffresDécimaux, le nombre est arrondi au nombre le plus proche, représenté avec nbChiffresDécimaux pour la partie fractionnaire. Voir la discussion sur les arrondis dans la page  de la méthode toFixed() pour plus de détails, la même méthode est utilisée pour toExponential().

Exemples

Utiliser toExponential

var numObj = 77.1234;

console.log(numObj.toExponential());  // affiche 7.71234e+1
console.log(numObj.toExponential(4)); // affiche 7.7123e+1
console.log(numObj.toExponential(2)); // affiche 7.71e+1
console.log(77.1234.toExponential()); // affiche 7.71234e+1
console.log(77 .toExponential());     // affiche 7.7e+1

Spécifications

Spécification État Commentaires
ECMAScript 3rd Edition (ECMA-262) Standard Définition initiale. Implémentée avec JavaScript 1.5.
ECMAScript 5.1 (ECMA-262)
La définition de 'Number.prototype.toExponential' dans cette spécification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'Number.prototype.toExponential' dans cette spécification.
Standard  
ECMAScript (ECMA-262)
La définition de 'Number.prototype.toExponential' dans cette spécification.
Standard évolutif  

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobileServeur
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung InternetNode.js
toExponentialChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 5.5Opera Support complet 7Safari Support complet 2WebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet 10.1Safari iOS Support complet 1Samsung Internet Android Support complet 1.0nodejs Support complet 0.1.100

Légende

Support complet  
Support complet

Voir aussi