reduce

  • Enlace amigable (slug) de la revisión: Referencia_de_JavaScript_1.5/Objetos_globales/Array/reduce
  • Título de la revisión: reduce
  • Id de la revisión: 175214
  • Creada:
  • Creador: Talisker
  • ¿Es la revisión actual? No
  • Comentario /* Descripción */

Contenido de la revisión

Resumen

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

Método de Array
Implementado en: JavaScript 1.8 (Gecko 1.9a5 y posteriores)
Edición ECMAScript: Ninguna

Sintaxis

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

Parámetros

funcion 
Función a ejecutar para cada valor del arreglo.
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 arreglo 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 arreglo. 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 arreglo 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 arreglo 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 arreglo

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

Ejemplo: Integrar un arreglo a partir de arreglos

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

Vea también

reduceRight


{{ wiki.languages( { "en": "en/Core_JavaScript_1.5_Reference/Objects/Array/reduce", "fr": "fr/R\u00e9f\u00e9rence_de_JavaScript_1.5_Core/Objets_globaux/Array/reduce", "ja": "ja/Core_JavaScript_1.5_Reference/Objects/Array/reduce" } ) }}

Fuente de la revisión

<p>
</p>
<h3 name="Resumen"> Resumen </h3>
<p>Aplica una función simultáneamente a dos valores de un array (de izquierda a derecha) para reducirlo a un único valor.
</p>
<table class="fullwidth-table">
<tbody><tr>
<td class="header" colspan="2">Método de <a href="es/Referencia_de_JavaScript_1.5/Objetos_globales/Array">Array</a></td>
</tr>
<tr>
<td>Implementado en:</td>
<td>JavaScript 1.8 (Gecko 1.9a5 y posteriores)</td>
</tr>
<tr>
<td>Edición ECMAScript:</td>
<td>Ninguna</td>
</tr>
</tbody></table>
<h3 name="Sintaxis"> Sintaxis </h3>
<pre class="eval">var <i>resultado</i> = <i>array</i>.reduce(<i>funcion</i>[, <i>valorInicial</i>]);
</pre>
<h3 name="Par.C3.A1metros"> Parámetros </h3>
<dl><dt> <code>funcion</code> </dt><dd> Función a ejecutar para cada valor del arreglo.
</dd><dt> <code>valorInicial</code> </dt><dd> Objeto a usar como primer argumento en la primera llamada de la <code>funcion</code>.
</dd></dl>
<h3 name="Descripci.C3.B3n"> Descripción </h3>
<p><code>reduce</code> ejecuta la <code>funcion</code> 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 <code>funcion</code>), el valor del elemento actual, el índice actual y el arreglo sobre el que ocurre la iteración.
</p><p>La llamada a la <code>funcion</code> de reduce sería similar a esto:
</p>
<pre class="eval">.reduce(function(valorPrevio, valorActual, indice, array){
  // ...
})
</pre>
<p>La primera vez que se llama a la función, el <code>valorPrevio</code> y el <code>valorActual</code> puede ser uno de los dos valores. Si se incluye un <code>valorInicial</code> en la llamada a <code>reduce</code>, entonces el <code>valorPrevio</code> será igual al <code>valorInicial</code> y el <code>valorActual</code> será igual al primer valor del arreglo. Si no se incluye ningún <code>valorInicial</code>, entonces el <code>valorPrevio</code> será igual al primer valor del array y el <code>valorActual</code> será igual al segundo.
</p><p>Algún ejemplo de la ejecución paso a paso de la función sería similar a esto:
</p>
<pre class="eval">[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
</pre>
<p>Y si proporcionas un <code>valorInicial</code>, el resultado sería como este:
</p>
<pre class="eval">[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
</pre>
<h3 name="Compatibilidad"> Compatibilidad </h3>
<p><code>reduce</code> 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 <code>reduce</code> en implementaciones de ECMA-262 que no lo implementan de modo nativo. Este algoritmo es exactamente el mismo usando en Firefox y SpiderMonkey.
</p>
<pre class="eval">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 arreglo está vacío
    if (longitud == 0 &amp;&amp; arguments.length == 1)
      throw new TypeError();

    var indice = 0;
    if (arguments.length &gt;= 2)
    {
      var rv = arguments[1];
    }
    else
    {
      do
      {
        if (indice in this)
        {
          rv = this[indice++];
          break;
        }

        // si el arreglo no contiene valores, no existe valor inicial a devolver
        if (++indice &gt;= longitud)
          throw new TypeError();
      }
      while (true);
    }

    for (; indice &lt; longitud; indice++)
    {
      if (indice in this)
        rv = fun.call(null, rv, this[indice], indice, this);
    }

    return rv;
  };
}
</pre>
<h3 name="Ejemplos"> Ejemplos </h3>
<h4 name="Ejemplo:_Resumir_todos_los_valores_de_un_arreglo"> Ejemplo: Resumir todos los valores de un arreglo </h4>
<pre class="eval">var total = [0, 1, 2, 3].reduce(function(a, b){ return a + b; });
// total == 6
</pre>
<h4 name="Ejemplo:_Integrar_un_arreglo_a_partir_de_arreglos"> Ejemplo: Integrar un arreglo a partir de arreglos </h4>
<pre class="eval">var integrado = [[0,1], [2,3], [4,5]].reduce(function(a,b) {
  return a.concat(b);
}, []);
// integrado es [0, 1, 2, 3, 4, 5]
</pre>
<h3 name="Vea_tambi.C3.A9n"> Vea también </h3>
<p><a href="es/Referencia_de_JavaScript_1.5/Objetos_globales/Array/reduceRight">reduceRight</a>
</p><p><br>
</p>
<div class="noinclude">
</div>
{{ wiki.languages( { "en": "en/Core_JavaScript_1.5_Reference/Objects/Array/reduce", "fr": "fr/R\u00e9f\u00e9rence_de_JavaScript_1.5_Core/Objets_globaux/Array/reduce", "ja": "ja/Core_JavaScript_1.5_Reference/Objects/Array/reduce" } ) }}
Revertir a esta revisión