mozilla
Los resultados de tu búsqueda

    Array.prototype.reduce()

    Resumen

    Aplica una función simultáneamente a dos valores de un array (de izquierda a derecha) para reducirlo a un único valor.

    Sintaxis

    var resultado =array.reduce(funcion[,valorInicial]);
    

    Parámetros

    funcion
    Función a ejecutar para cada valor del array.
    valorInicial
    Objeto a usar como primer argumento en la primera llamada de la funcion.

    Descripción

    reduce ejecuta la funcion una vez para cada elemento presente en el array, excluyendo los huecos del mismo, recibiendo cuatro argumentos: el valor inicial (o valor de la llamada previa de funcion), el valor del elemento actual, el índice actual y el array sobre el que ocurre la iteración.

    La llamada a la funcion de reduce sería similar a esto:

    .reduce(function(valorPrevio, valorActual, indice, array){
      // ...
    })
    

    La primera vez que se llama a la función, el valorPrevio y el valorActual puede ser uno de los dos valores. Si se incluye un valorInicial en la llamada a reduce, entonces el valorPrevio será igual al valorInicial y el valorActual será igual al primer valor del array. Si no se incluye ningún valorInicial, entonces el valorPrevio será igual al primer valor del array y el valorActual será igual al segundo.

    Algún ejemplo de la ejecución paso a paso de la función sería similar a esto:

    [0,1,2,3,4].reduce(function(valorPrevio, valorActual, indice, array){
      return valorPrevio + valorActual;
    });
    
    // Primera llamada
    valorPrevio = 0, valorActual = 1, indice = 1
    
    // Segunda llamada
    valorPrevio = 1, valorActual = 2, indice = 2
    
    // Tercera llamada
    valorPrevio = 3, valorActual = 3, indice = 3
    
    // Cuarta llamada
    valorPrevio = 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: 10
    

    Y si proporcionas un valorInicial, el resultado sería como este:

    [0,1,2,3,4].reduce(function(valorPrevio, valorActual, indice, array){
      return valorPrevio + valorActual;
    }, 10);
    
    // Primera llamada
    valorPrevio = 10, valorActual = 0, indice = 0
    
    // Segunda llamada
    valorPrevio = 10, valorActual = 1, indice = 1
    
    // Tercera llamada
    valorPrevio = 11, valorActual = 2, indice = 2
    
    // Cuarta llamada
    valorPrevio = 13, valorActual = 3, indice = 3
    
    // Quinta llamada
    valorPrevio = 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: 20
    

    Compatibilidad

    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 de reduce 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: Resumir todos los valores de un array

    var total = [0, 1, 2, 3].reduce(function(a, b){ return a + b; });
    // total == 6
    

    Ejemplo: Integrar un array a partir de varios arrays

    var integrado = [[0,1], [2,3], [4,5]].reduce(function(a,b) {
      return a.concat(b);
    }, []);
    // integrado es [0, 1, 2, 3, 4, 5]
    

    Véase también

    Etiquetas y colaboradores del documento

    Contributors to this page: teoli, cpf, Talisker
    Última actualización por: cpf,