Math.sumPrecise()

Try it

Syntax

Parameters

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

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:

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:

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()

Specifications

Browser compatibility

Enable JavaScript to view this browser compatibility table.

See also

• Polyfill of Math.sumPrecise in core-js
• es-shims polyfill of Math.sumPrecise
• Array.prototype.reduce()