Number : méthode toExponential()

Exemple interactif

function expo(x, f) {
  return Number.parseFloat(x).toExponential(f);
}

console.log(expo(123456, 2));
// Sortie attendue : "1.23e+5"

console.log(expo("123456"));
// Sortie attendue : "1.23456e+5"

console.log(expo("oink"));
// Sortie attendue : "NaN"

Syntaxe

toExponential()
toExponential(fractionDigits)

Paramètre

fractionDigits Facultatif

Optionnel. Un entier définissant le nombre de chiffres après la virgule. Par défaut, autant de chiffres que nécessaire pour représenter le nombre.

Valeur de retour

Une chaîne de caractères représentant l'objet Number donné en notation exponentielle avec un chiffre avant la virgule et arrondi à fractionDigits chiffres après la virgule.

Exceptions

RangeError

Levée si fractionDigits n'est pas compris entre 0 et 100 (inclus).

TypeError

Levée si cette méthode est invoquée pour un objet qui n'est pas un Number.

Description

Si l'argument fractionDigits est omis, le nombre de chiffres après la virgule par défaut est le nombre de chiffres nécessaires pour représenter la valeur de manière unique.

Si vous utilisez la méthode toExponential() pour un littéral numérique et que le littéral numérique n'a pas d'exposant et pas de point décimal, laissez des espaces avant le point qui précède l'appel de méthode pour éviter que le point ne soit interprété comme un point décimal.

Si un nombre a plus de chiffres que ceux demandés par le paramètre fractionDigits, le nombre est arrondi au nombre le plus proche représenté par fractionDigits chiffres. Voir la discussion sur l'arrondi dans la description de la méthode toFixed(), qui s'applique également à toExponential().

Exemples

Utiliser toExponential()

const numObj = 77.1234;

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

Spécifications

Compatibilité des navigateurs

Voir aussi

• La prothèse d'émulation de Number.prototype.toExponential avec de nombreux correctifs de bogues dans core-js ^(angl.)
• La prothèse d'émulation es-shims de Number.prototype.toExponential ^(angl.)
• La méthode Number.prototype.toFixed()
• La méthode Number.prototype.toPrecision()
• La méthode Number.prototype.toString()