Math.sumPrecise()

numbers

Ein iterierbares Objekt (wie ein Array) von Zahlen.

Eine Zahl, die die Summe der Zahlen im iterierbaren numbers-Objekt darstellt. Wenn das iterierbare Objekt leer ist, ist der Rückgabewert -0 (nicht 0).

TypeError

Wenn numbers kein iterierbares Objekt ist oder wenn eine der Zahlen im iterierbaren Objekt nicht vom Typ Zahl ist.

Da sumPrecise() eine statische Methode von Math ist, verwenden Sie sie immer als Math.sumPrecise() und nicht als Methode eines von Ihnen erstellten Math-Objekts (Math ist kein Konstruktor).

Die Methode heißt Math.sumPrecise(), weil sie präziser ist als das naive Aufsummieren von Zahlen in einer Schleife. Betrachten Sie das folgende Beispiel:

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

Das Ergebnis ist 0. Das liegt daran, dass 1e20 + 0.1 in 64-Bit-Gleitkommazahlen nicht genau dargestellt werden kann, sodass das Zwischenergebnis auf 1e20 gerundet wird. Dann ist die Summe von 1e20 und -1e20 0, sodass das Endergebnis 0 ist.

Math.sumPrecise() vermeidet dieses Problem, indem es einen spezialisierten Algorithmus zum Summieren verwendet. Es funktioniert, als ob die Gleitkommazahlen unter Verwendung ihrer präzisen mathematischen Werte summiert werden und das Endergebnis dann in die nächste darstellbare 64-Bit-Gleitkommazahl umgewandelt wird. Dies kann jedoch nicht das Precision-Problem von 0.1 + 0.2 vermeiden:

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

Da die Gleitkommazahlenliterale 0.1 und 0.2 bereits mathematische Werte darstellen, die größer sind als 0.1 und 0.2, und die nächste 64-Bit-Gleitkommazahlendarstellung ihrer Summe tatsächlich 0.30000000000000004 ist.

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