Math.sumPrecise()

Определение и применение

Math.sumPrecise() складывает последовательность чисел так, чтобы избежать потерь на промежуточных округлениях. Итог округляется до представимого number. Это полезно, когда в одной сумме встречаются очень большие и очень маленькие слагаемые.

Поддержка браузерами

Спецификация: ecma262

Нет поддержки: Samsung Android.

Показать браузеры
Совместимостьjavascript.builtins.Math.sumPrecise
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
sumPrecise✓147✓147✓137✓131✓26.2✓147✓137✓98✓26.2×✓147✓26.2

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

Синтаксис

JavaScript
Math.sumPrecise(numbers);

numbers — перебираемый источник чисел, например массив. Передавайте его одним аргументом. Метод читает элементы и возвращает число; обычный массив не изменяется, а переданный итератор расходуется.

Что именно становится точнее

При обычном сложении 1e16 + 1 - 1e16 единица теряется на первом шаге и получается ноль. Math.sumPrecise([1e16, 1, -1e16]) сохраняет это слагаемое и возвращает единицу. В примере можно поменять порядок чисел и сравнить способы суммирования.

Метод получает уже представленные в формате number значения. Он не исправляет неточность исходных десятичных дробей: сумма 0.1 и 0.2 по-прежнему может отличаться от 0.3. Для денег выбор единиц и способа хранения остаётся отдельной задачей.

Пустой набор и особые значения

Пустой источник даёт -0. Элемент NaN либо сочетание положительной и отрицательной бесконечностей приводит к NaN. Строки не преобразуются в числа: даже "2" является ошибкой. Это отличается от многих других методов Math.

Проверка поддержки

Перед использованием проверяйте typeof Math.sumPrecise === "function". Обычная сумма в цикле или через reduce() не является равнозначной заменой. При отсутствии API примеры выводят понятное сообщение.

Исключения

Исключения Math.sumPrecise()
Тип исключения Условие
TypeError Аргумент нельзя перебрать или хотя бы один элемент не имеет тип number, включая строку и BigInt. Ошибка итератора также прерывает вычисление.

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

ECMAScript: Math.sumPrecise.

Примеры, попробуйте сами

Малое слагаемое между большими числами

Измените среднее слагаемое или порядок элементов. Сравните обычную сумму с точным суммированием исходных чисел.

index.html
HTML
<!doctype html>
<html lang="ru">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>Малое слагаемое между большими числами</title>
  </head>
  <body>
    <p>Откройте консоль браузера, чтобы увидеть результат.</p>
    <script src="main.js"></script>
  </body>
</html>
main.js
JavaScript
const values = [1e16, 1, -1e16]
console.log(values.reduce((total, value) => total + value, 0))
if (typeof Math.sumPrecise === 'function') {
    console.log(Math.sumPrecise(values))
    console.log(Math.sumPrecise([0.1, 0.2]) === 0.3)
} else {
    console.log('Math.sumPrecise() не поддерживается этим браузером')
}

Пустая сумма и строка вместо числа

Замените строку "2" числом 2: вместо имени ошибки появится сумма. Ошибка намеренно перехвачена для сравнения.

index.html
HTML
<!doctype html>
<html lang="ru">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>Пустая сумма и строка вместо числа</title>
  </head>
  <body>
    <p>Откройте консоль браузера, чтобы увидеть результат.</p>
    <script src="main.js"></script>
  </body>
</html>
main.js
JavaScript
if (typeof Math.sumPrecise === 'function') {
    console.log(Object.is(Math.sumPrecise([]), -0))
    try {
        console.log(Math.sumPrecise([1, '2']))
    } catch (error) {
        console.log(error.name)
    }
} else {
    console.log('Math.sumPrecise() не поддерживается этим браузером')
}