HOWTO · JavaScript
Summe des Arrays von Objekten in JavaScript
Dieses Tutorial zeigt, wie man ein Array von Objekten in JavaScript summiert
Auf dieser Seite
Um eine Eigenschaft über ein Array von Objekten hinweg zu summieren, addieren Sie ihren Wert beim Durchlaufen jedes Objekts zu einer laufenden Summe. Hat jedes Objekt beispielsweise einen numerischen Wert für amount, kann JavaScripts reduce() daraus eine Gesamtsumme bilden. Dieselbe Berechnung lässt sich auch mit forEach oder einer for...of-Schleife ausführen, wenn Sie jeden Iterationsschritt lieber explizit sehen möchten.
Die Beispiele verwenden dieselben drei Datensätze, damit Sie die Ansätze vergleichen können; ihre amount-Werte ergeben zusammen 600.
Objekteigenschaften mit reduce() summieren
reduce() ruft für jedes Array-Element einen Callback auf und übernimmt dessen Rückgabewert als Akkumulator für den nächsten Aufruf. Das erste Callback-Argument unten ist die laufende Summe, das zweite das aktuelle Objekt. Die abschließende 0 ist der Anfangswert des Akkumulators. Damit hat die Berechnung auch dann einen festgelegten Startwert, wenn das Array keine Datensätze enthält.
Führen Sie dieses Beispiel aus:
Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.
const items = [
{ id: 1, amount: 100 },
{ id: 2, amount: 200 },
{ id: 3, amount: 300 },
];
const total = items.reduce((sum, item) => sum + item.amount, 0);
console.log(total);
Damit wird die Eigenschaft amount summiert, bei der Groß- und Kleinschreibung berücksichtigt werden, und das Ergebnis als Zahl ausgegeben. Eigenschaftsnamen müssen in Schreibweise und Groß-/Kleinschreibung übereinstimmen: item.Amount bezeichnet eine andere Eigenschaft. Verwenden Sie reduce(), wenn ein einzelnes akkumuliertes Ergebnis die Transformation verständlich macht. Wird der zu addierende Wert aus jedem Objekt abgeleitet, berechnen Sie ihn im Callback. Ein separates map() kann Werte ebenfalls abbilden, transformiert aber jedes Element und filtert keine Datensätze.
Objekteigenschaften mit forEach() summieren
forEach durchläuft jedes Array-Element und führt einen Callback aus, gibt aber nicht die angesammelte Summe zurück. Initialisieren Sie vor dem Callback eine separate Variable und addieren Sie dann die Eigenschaft jedes Elements zu ihr. Das lässt sich leichter lesen, wenn die Aktualisierung mehrere Anweisungen umfasst.
Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.
const items = [
{ id: 1, amount: 100 },
{ id: 2, amount: 200 },
{ id: 3, amount: 300 },
];
let total = 0;
items.forEach((item) => {
total += item.amount;
});
console.log(total);
Der Akkumulator muss mit let deklariert werden, weil der Callback seinen Wert ändert. Beschränken Sie die Summe auf den Bereich der Berechnung und erwarten Sie nicht, dass der Rückgabewert von forEach die Summe enthält. Wählen Sie diese Variante, wenn ein expliziter Callback und eine benannte laufende Summe den Code für Ihr Team verständlicher machen.
Objekteigenschaften mit einer for...of-Schleife summieren
Eine for...of-Schleife durchläuft ebenfalls jedes Element eines iterierbaren Arrays. Ihr direkter Schleifenrumpf ist praktisch, wenn Sie Datensätze überspringen, mehrere Eigenschaften untersuchen oder weitere Steuerlogik in die Berechnung aufnehmen müssen.
Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.
const items = [
{ id: 1, amount: 100 },
{ id: 2, amount: 200 },
{ id: 3, amount: 300 },
];
let total = 0;
for (const item of items) {
total += item.amount;
}
console.log(total);
Für eine einfache Summe drücken alle drei Muster dieselbe Addition aus. Wählen Sie das Muster, das die umgebende Logik am verständlichsten macht; die vorliegenden Informationen enthalten keinen Benchmark, der einen allgemeinen Geschwindigkeitsvorteil einer Variante belegt. Alle Beispiele setzen voraus, dass amount eine Zahl ist. Wird ein String addiert, kann er mit der laufenden Summe verkettet werden; beim Addieren von undefined entsteht dagegen NaN. Legen Sie daher fest, wie Eingabedaten validiert oder normalisiert werden sollen.
Fehlende Werte und bedingte Summen behandeln
Wenn eine Eigenschaft fehlen oder null sein kann, entscheiden Sie, ob dieser Datensatz nichts zur Summe beitragen oder ob die Daten zurückgewiesen werden sollen. Sollen beide Fälle als null behandelt werden, verwenden Sie den Nullish-Coalescing-Operator. Er erhält einen gültigen Zahlenwert von 0, anders als eine Ersetzung anhand des Wahrheitswerts.
Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.
const items = [
{ id: 1, amount: 100 },
{ id: 2 },
{ id: 3, amount: null },
];
const total = items.reduce((sum, item) => sum + (item.amount ?? 0), 0);
console.log(total);
Nullish Coalescing behandelt null und undefined; beliebige Strings werden dadurch nicht zu gültigen Zahlen. Validieren Sie bei externen Daten den Wert, bevor Sie ihn addieren. Prüfen Sie zum Beispiel typeof item.amount === "number" und überspringen Sie nicht numerische Werte oder melden Sie sie, je nachdem, was die Anwendung erfordert. Wandeln Sie Werte nicht stillschweigend um, sofern das Eingabeformat nicht festlegt, wie diese Umwandlung erfolgen soll.
Um nur passende Objekte einzubeziehen, platzieren Sie die Bedingung im Akkumulations-Callback oder in der Schleife. So wird map() nicht fälschlich als Filter verwendet. Das folgende Beispiel summiert nur die Beträge von Datensätzen, deren paid-Flag auf true gesetzt ist:
const items = [
{ amount: 100, paid: true },
{ amount: 200, paid: false },
{ amount: 300, paid: true },
];
const paidTotal = items.reduce(
(sum, item) => sum + (item.paid ? item.amount : 0),
0
);
console.log(paidTotal);
Sie können mehrere Eigenschaften in einem Durchlauf aufsummieren, indem Sie ein Objekt als Akkumulator für reduce() verwenden, etwa { amount: 0, tax: 0 }, und für jedes Element ein aktualisiertes Objekt zurückgeben. Für die Summe einer einzelnen Eigenschaft ist ein numerischer Akkumulator einfacher. Wählen Sie in der Praxis zwischen reduce(), forEach und for...of danach, ob ein zurückgegebener Akkumulatorwert, ein expliziter Callback oder die direkte Schleifensteuerung am besten zur Berechnung passt.