HOWTO · JavaScript
Suma del array de objetos en JavaScript
Este tutorial demuestra cómo sumar un array de objetos en javascript.
En esta página
Para sumar una propiedad de un array de objetos, añade el valor de esa propiedad a un total acumulado cada vez que recorras un objeto. Por ejemplo, si cada objeto tiene un amount numérico, reduce() de JavaScript puede calcular un único total. También puedes hacer el mismo cálculo con forEach o con un bucle for...of si prefieres ver explícitamente cada iteración.
Los ejemplos usan los mismos tres registros para que puedas comparar los enfoques; sus valores de amount suman 600.
Sumar propiedades de objetos con reduce()
reduce() llama a una función de retorno de llamada por cada elemento del array y conserva el valor que devuelve esa función como acumulador para la siguiente iteración. El primer argumento de la función que aparece abajo es ese total acumulado; el segundo es el objeto actual. El 0 final es el valor inicial del acumulador, por lo que el cálculo también tiene un punto de partida definido cuando el array no contiene registros.
Ejecuta este ejemplo:
El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.
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);
Este cálculo suma la propiedad amount, que distingue entre mayúsculas y minúsculas, y muestra el número resultante. Los nombres de las propiedades deben coincidir en escritura y capitalización: item.Amount hace referencia a una propiedad distinta. Usa reduce() cuando un único resultado acumulado ayude a entender la transformación. Si el valor que se va a sumar se deriva de cada objeto, calcúlalo dentro de la función de retorno de llamada; también puedes usar map() por separado para proyectar valores, pero map() transforma todos los elementos y no filtra registros.
Sumar propiedades de objetos con forEach()
forEach recorre cada elemento del array y ejecuta una función de retorno de llamada, pero no devuelve el total acumulado. Antes de esa función, inicializa una variable independiente y luego suma en ella la propiedad de cada elemento. Esta opción puede resultar más fácil de leer cuando la actualización requiere varias instrucciones.
El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.
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);
El acumulador debe declararse con let porque la función de retorno de llamada lo actualiza. Mantén el total dentro del ámbito del cálculo y no esperes que el valor devuelto por forEach contenga la suma. Elige esta forma cuando una función de retorno de llamada explícita y un total acumulado con nombre faciliten la lectura del código a tu equipo.
Sumar propiedades de objetos con un bucle for...of
Un bucle for...of también recorre cada elemento de un array iterable. Ofrece un cuerpo de bucle directo, lo que resulta útil si necesitas omitir registros, consultar más de una propiedad o añadir otras instrucciones de control al cálculo.
El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.
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);
Para obtener un total sencillo, estos tres patrones realizan la misma suma. Prefiere el que haga más fácil entender la lógica que lo rodea; el paquete no aporta ningún benchmark que respalde una ventaja general de velocidad para uno de los enfoques. Todos estos ejemplos suponen que amount es un número. Al sumar una cadena, esta puede concatenarse con el total acumulado, mientras que sumar undefined produce NaN; por eso, decide cómo validar o normalizar los datos de entrada.
Gestionar valores ausentes y sumas condicionales
Si una propiedad puede no existir o tener el valor null, decide si ese registro debe aportar cero o si los datos deben rechazarse. Si la política prevista es tratar cualquiera de esos casos como cero, usa la coalescencia de nulos. Esta conserva un valor numérico legítimo de 0, a diferencia de una alternativa basada en valores truthy.
El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.
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);
La coalescencia de nulos gestiona null y undefined; no convierte cadenas arbitrarias en números válidos. Si los datos proceden de una fuente externa, valida el valor antes de sumarlo. Por ejemplo, comprueba typeof item.amount === "number" y omite los valores no numéricos o notifícalos según las necesidades de la aplicación. No conviertas valores silenciosamente, salvo que el formato de entrada defina cómo debe hacerse esa conversión.
Para incluir solo los objetos que cumplan una condición, incorpora esa condición a la función de acumulación o al bucle. Así evitarás tratar map() como si fuera un filtro. El siguiente ejemplo suma los valores de amount únicamente para los registros cuyo indicador paid sea true:
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);
Puedes acumular más de una propiedad en una sola pasada usando un objeto como acumulador de reduce(), por ejemplo { amount: 0, tax: 0}, y devolviendo un objeto actualizado por cada elemento. Para sumar una sola propiedad, un acumulador numérico es más sencillo. En la práctica, elige entre reduce(), forEach y for...of según convenga más al cálculo devolver un valor acumulado, usar una función de retorno de llamada explícita o controlar directamente el bucle.