Esta página ha sido traducida del inglés por la comunidad.Aprende más y únete a la comunidad de MDN Web Docs.
Array.prototype.reduce()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julio de 2015.
El métodoreduce() ejecuta una funciónreductora sobre cada elemento de un array, devolviendo como resultado un único valor.
Pruébalo
const array1 = [1, 2, 3, 4];// 0 + 1 + 2 + 3 + 4const initialValue = 0;const sumWithInitial = array1.reduce( (accumulator, currentValue) => accumulator + currentValue, initialValue,);console.log(sumWithInitial);// Expected output: 10La funciónreductora recibe cuatro argumentos:
- Acumulador (
acc) - Valor Actual (
cur) - Índice Actual (
idx) - Array (
src)
El valor devuelto de la funciónreductora se asigna al acumulador, cuyo valor se recuerda en cada iteración de la matriz y, en última instancia, se convierte en el valor final, único y resultante.
Sintaxis
arr.reduce(callback(acumulador, valorActual[, índice[, array]])[, valorInicial])
Parámetros
callbackFunción a ejecutar sobre cada elemento del array (excepto para el primero, si no se proporciona
valorInicial), que recibe cuatro parámetros:_acumulador_ : El acumulador acumula el valor devuelto por la función callback. Es el valor acumulado devuelto en la última invocación de callback, o elvalorInicial, si se proveyó. (Ver a continuación).valorActualEl elemento actual que está siendo procesado en el array.
índiceOpcionalEl índice del elemento actual que está siendo procesado en el array. Empieza desde el índice 0 si se provee
valorInicial. En caso contrario, comienza desde el índice 1.arrayOpcionalEl array sobre el cual se llamó el método
reduce().
valorInicialOpcionalUn valor a usar como primer argumento en la primera llamada de la función
callback. Si no se proporciona elvalorInicial, el primer elemento del array será utilizado y saltado. Llamando areduce()sobre un array vacío sin unvalorIniciallanzará unTypeError.
Descripción
El métodoreduce() ejecutacallback una vez por cada elemento presente en el array, excluyendo los huecos del mismo, recibe cuatro argumentos:
valorAnteriorvalorActualindiceActualarray
La primera vez que se llama la función,valorAnterior yvalorActual pueden tener uno de dos valores. Si se proveyó unvalorInicial al llamar areduce, entoncesvalorAnterior será igual alvalorInicial yvalorActual será igual al primer elemento del array. Si no se proveyó unvalorInicial, entoncesvalorAnterior será igual al primer valor en elarray yvalorActual será el segundo.
Si elarray está vacío y no se proveyó unvalorInicial lanzará unTypeError. Si elarray tiene un sólo elemento (sin importar la posición) y no se proveyó unvalorInicial, o si se proveyó unvalorInicial pero el arreglo está vacío, se retornará ese único valor sin llamar a lafunción.
Suponga que ocurre el siguiente uso dereduce:
[0, 1, 2, 3, 4].reduce(function (valorAnterior, valorActual, indice, vector) { return valorAnterior + valorActual;});// Primera llamada((valorAnterior = 0), (valorActual = 1), (indice = 1));// Segunda llamada((valorAnterior = 1), (valorActual = 2), (indice = 2));// Tercera llamada((valorAnterior = 3), (valorActual = 3), (indice = 3));// Cuarta llamada((valorAnterior = 6), (valorActual = 4), (indice = 4));// el array sobre el que se llama a reduce siempre es el objeto [0,1,2,3,4]// Valor Devuelto: 10Y si proporcionas unvalorInicial, el resultado sería como este:
[0, 1, 2, 3, 4].reduce(function (valorAnterior, valorActual, indice, vector) { return valorAnterior + valorActual;}, 10);// Primera llamada((valorAnterior = 10), (valorActual = 0), (indice = 0));// Segunda llamada((valorAnterior = 10), (valorActual = 1), (indice = 1));// Tercera llamada((valorAnterior = 11), (valorActual = 2), (indice = 2));// Cuarta llamada((valorAnterior = 13), (valorActual = 3), (indice = 3));// Quinta llamada((valorAnterior = 16), (valorActual = 4), (indice = 4));// el array sobre el que se llama a reduce siempre es el objeto [0,1,2,3,4]// Valor Devuelto: 20Polyfill
Nota:Polyfill se refiere a unas líneas de código o un plugin que permite "tener" (en realidad se simulan de alguna otra manera) las nuevas funcionalidades de HTML5 en aquellos navegadores que nativamente no lo soportan. Consigue que, en adelante, el código sea transparente para el programador, como si el navegador soportase la funcionalidad nativamente.
reduce es una extensión de JavaScript al estándar ECMA-262; como tal puede que no esté presente en otras implementaciones del estándar. Puedes trabajar con ésto insertando el siguiente código al comienzo de tus scripts, permitiendo el uso dereduce en implementaciones de ECMA-262 que no lo implementan de modo nativo. Este algoritmo es exactamente el mismo usando en Firefox y SpiderMonkey.
if (!Array.prototype.reduce) { Array.prototype.reduce = function (fun /*, inicial*/) { var longitud = this.length; if (typeof fun != "function") throw new TypeError(); // no se devuelve ningún valor si no hay valor inicial y el array está vacío if (longitud == 0 && arguments.length == 1) throw new TypeError(); var indice = 0; if (arguments.length >= 2) { var rv = arguments[1]; } else { do { if (indice in this) { rv = this[indice++]; break; } // si el array no contiene valores, no existe valor inicial a devolver if (++indice >= longitud) throw new TypeError(); } while (true); } for (; indice < longitud; indice++) { if (indice in this) rv = fun.call(null, rv, this[indice], indice, this); } return rv; };}Ejemplos
Ejemplo: Sumar todos los valores de unarray
var total = [0, 1, 2, 3].reduce(function (a, b) { return a + b;});// total == 6Ejemplo: Integrar unarray a partir de variosarrays
var integrado = [ [0, 1], [2, 3], [4, 5],].reduce(function (a, b) { return a.concat(b);});// integrado es [0, 1, 2, 3, 4, 5]Especificaciones
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-array.prototype.reduce |