Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Number.prototype.toExponential: notación exponencial

toExponential devuelve texto exponencial con un dígito antes del punto y la cantidad solicitada después.

Versión: ECMAScript 3 onward; example target: Node.js 24.22.2

Sintaxis

number.toExponential(fractionDigits)

number.toExponential(fractionDigits) formatea un Number como texto decimal con e minúscula, signo explícito del exponente y un dígito antes del punto. Si fractionDigits es undefined, elige la secuencia más corta que identifica el Number sin ambigüedad. Si se proporciona, el resultado tiene exactamente esa cantidad de dígitos tras el punto.

El argumento pasa por ToIntegerOrInfinity: las fracciones se truncan hacia cero y NaN se vuelve 0. Para un receptor finito se admite 0..100; fuera del rango y ±Infinity lanzan RangeError. Sin embargo, primero se convierte el argumento y luego un receptor no finito devuelve texto antes de validar el rango; por eso Infinity.toExponential(101) da "Infinity", aunque un objeto argumento aún puede lanzar al convertirse.

El método existe desde ECMAScript 3, no es genérico y lanza TypeError si el receptor no es Number ni un Number envuelto. Redondea al resultado matemático más cercano y, en empate tras separar el signo, elige la mayor magnitud; la representación binaria puede sorprender. El cero negativo se formatea sin signo menos.

Ejemplos

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); }

Resultado

1.23e+3 1.25e-3
7e+0 0.0e+0
Infinity
RangeError
TypeError

El ejemplo muestra dígitos fijos, argumento omitido, -0 y el orden entre Infinity y RangeError.

Fuentes