Math.sumPrecise()
Определение и применение
Math.sumPrecise() складывает последовательность чисел так, чтобы избежать потерь на промежуточных
округлениях. Итог округляется до представимого number. Это полезно, когда в одной сумме встречаются очень
большие и очень маленькие слагаемые.
Поддержка браузерами
Спецификация: ecma262
Нет поддержки: Samsung Android.
| Возможность | Компьютеры | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
sumPrecise | 147 | 147 | 137 | 131 | 26.2 | 147 | 137 | 98 | 26.2 | 147 | 26.2 | |
поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31
Синтаксис
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 примеры выводят понятное сообщение.
Исключения
| Тип исключения | Условие |
|---|---|
TypeError |
Аргумент нельзя перебрать или хотя бы один элемент не имеет тип number, включая строку и
BigInt. Ошибка итератора также прерывает вычисление.
|
Спецификация
Примеры, попробуйте сами
Малое слагаемое между большими числами
Измените среднее слагаемое или порядок элементов. Сравните обычную сумму с точным суммированием исходных чисел.
index.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
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 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
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() не поддерживается этим браузером')
}
Нажмите , чтобы запустить пример.