大网数据广告活动
Web 标准与前端开发

Math.sumPrecise()

· 52CE 我爱测

The **`Math.sumPrecise()`** static method takes an iterable of numbers and returns the sum of them. It is more precise than summing them up in a loop, because it avoids floating point precision loss in intermediate results.

The Math.sumPrecise() static method takes an iterable of numbers and returns the sum of them. It is more precise than summing them up in a loop, because it avoids floating point precision loss in intermediate results.

JavaScript Demo: Math.sumPrecise()

console.log(Math.sumPrecise([1, 2]));
// Expected output: 3

console.log(Math.sumPrecise([1e20, 0.1, -1e20]));
// Expected output: 0.1

Syntax

Math.sumPrecise(numbers)

Parameters

  • numbers
    • : An iterable (such as an Array) of numbers.

Return value

A number that is the sum of the numbers in the numbers iterable. If the iterable is empty, the return value is -0 (not 0).

Exceptions

  • TypeError
    • : If numbers is not an iterable, or if any of the numbers in the iterable is not of the number type.

Description

Because sumPrecise() is a static method of Math, you always use it as Math.sumPrecise(), rather than as a method of a Math object you created (Math is not a constructor).

The method is called Math.sumPrecise() because it is more precise than naïvely summing up numbers in a loop. Consider the following example:

let sum = 0;
const numbers = [1e20, 0.1, -1e20];
for (const number of numbers) {
  sum += number;
}
console.log(sum); // 0

The output is 0. This is because 1e20 + 0.1 cannot be represented precisely in 64-bit floats, so the intermediate result is rounded to 1e20. Then, the sum of 1e20 and -1e20 is 0, so the final result is 0.

Math.sumPrecise() avoids this issue by using some specialized summing algorithm. It works as if the floating point numbers are summed up using their precise mathematical values, and the final result is then converted to the nearest representable 64-bit float. This still cannot avoid the 0.1 + 0.2 precision problem:

console.log(Math.sumPrecise([0.1, 0.2])); // 0.30000000000000004

Because the floating point literals 0.1 and 0.2 already represent mathematical values greater than 0.1 and 0.2, and their sum's closest 64-bit float representation is actually 0.30000000000000004.

Examples

Using Math.sumPrecise()

console.log(Math.sumPrecise([1, 2, 3])); // 6
console.log(Math.sumPrecise([1e20, 0.1, -1e20])); // 0.1

Specifications

Browser compatibility

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。