Number.prototype.toExponential()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Сводка

Метод toExponential() возвращает строку, представляющую объект Number в экспоненциальной записи.

Синтаксис

numObj.toExponential([fractionDigits])

Параметры

fractionDigits: Необязательный параметр. Целое число, определяющее количество цифр после десятичной запятой. По умолчанию используется столько цифр, сколько необходимо для указания числа.

Строка, представляющая объект Number в экспоненциальной записи с одной цифрой перед десятичной запятой, округлённое до fractionDigits цифр после десятичной запятой. Если аргумент fractionDigits опущен, количество цифр после десятичной запятой по умолчанию устанавливается в количество цифр, необходимых для однозначного представления значения.

Если вы используете метод toExponential() с числовыми литералами и числовой литерал не имеет экспоненты и десятичной запятой, оставьте пробел перед точкой, предшествующей вызову метода для предотвращения интерпретации этой точки как десятичной запятой.

Если число имеет больше цифр, чем запрошено параметром fractionDigits, оно будет округлено к ближайшему числу, представляемому fractionDigits цифрами. Смотрите обсуждение округления в описании метода toFixed(), которое так же применяется и к методу toExponential().

Выбрасываемые исключения

RangeError: Если параметр fractionDigits слишком маленький или слишком большой. Значения между 0 и 20 включительно не будут порождать исключение RangeError. Также реализации могут поддерживать большие и меньшие значения.
TypeError: Если этот метод вызывается на объекте, не являющимся объектом Number.

Примеры

Пример: использование `toExponential`

var 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

Спецификации

Specification
ECMAScript® 2026 Language Specification # sec-number.prototype.toexponential