Esta traducción está incompleta. Por favor, ayuda a traducir este artículo del inglés.

La sintaxis de los parámetros rest nos permiten representar un número indefinido de argumentos como un arreglo.

Sintaxis

function(a, b, ...theArgs) {
  // ...
}

Descripción

Si el ultimo argumento definido de una función se le antepone con ..., éste se convierte en un arreglo cuyos elementos desde 0 (inclusivo) hasta theArgs.length (exclusivo) son pasados a la función.

En el ejemplo superior, theArgs debería recolectar el tercer argumento de la función (debido a que el primero está asignado a a y el segundo a b) y todos los argumentos consecutivos.

Diferencia entre los parámetros rest y el objeto arguments

Hay tres principales diferencias entre los parámetros rest y el objeto arguments:

  • los parámetros rest son sólo los que no se les ha asignado un nombre, mientras que el objeto arguments contiene todos los argumentos pasados a la función;
  • el objeto arguments no es un arreglo real, mientras los parámetros rest son instancias de  Array , lo que significa que lo los metodos como sort, map, forEachpop pueden aplicarse directamente;
  • el objeto arguments tiene una funcionalidad adicional específica para sí mismo (como la propiedad callee).

De argumentos a un arreglo

Los parámetros rest han sido agregados para reducir el codigo repetitivo que se usaba en los parámetros.

// Antes de los parámetros rest se realizaba:
function f(a, b){
  var args = Array.prototype.slice.call(arguments, f.length);

  // …
}

// Ahora es equivalente a 

function f(a, b, ...args) {
  
}

Desestructuración de los parametros rest

Los parametros rest pueden ser desestructurados, eso significa que sus datos pueden ser desempaquetados dentro de distintas variables. Ver Destructuring assignment.

function f(...[a, b, c]) {
  return a + b + c;
}

f(1)          // NaN (b y c son indefinidos)
f(1, 2, 3)    // 6
f(1, 2, 3, 4) // 6 (el cuarto parámetro no está desestructurado)

Ejemplos

Dado que theArgs es un arreglo, se puede obtener el tamaño del mismo usando la propiedad  length :

function fun1(...theArgs) {
  console.log(theArgs.length);
}

fun1();  // 0
fun1(5); // 1
fun1(5, 6, 7); // 3

En el siguiente ejemplo, se usa un parámetro rest para agrupar todos los argumentos despues del primero.  Luego cada uno es multiplicado por el primero y el arreglo es regresado:

function multiply(multiplier, ...theArgs) {
  return theArgs.map(function (element) {
    return multiplier * element;
  });
}

var arr = multiply(2, 1, 2, 3); 
console.log(arr); // [2, 4, 6]

El siguiente ejemplo se muestra que se puede usar los metodos de Array en los parámetros rest , pero no en el objeto arguments:

function sortRestArgs(...theArgs) {
  var sortedArgs = theArgs.sort();
  return sortedArgs;
}

console.log(sortRestArgs(5,3,7,1)); // muestra 1,3,5,7

function sortArguments() {
  var sortedArgs = arguments.sort(); 
  return sortedArgs; // esto nunca va a ocurrir
}

// throws a TypeError: arguments.sort is not a function
console.log(sortArguments(5,3,7,1));

Para poder usar los metodos de  Array en el objeto arguments object, se debe convertir a un arreglo real primero.

Especificaciones

Especificación Estado Comentario
ECMAScript 2015 (6th Edition, ECMA-262)
La definición de 'Function Definitions' en esta especificación.
Standard definción inicial.
ECMAScript Latest Draft (ECMA-262)
La definición de 'Function Definitions' en esta especificación.
Draft  

Compatibilidad en Navegadores

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Característica Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Soporte Básico 47 (Yes) 15.0 (15.0) Sin soporte 34 Sin soporte
Característica Android Android Webview Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile Chrome for Android
Soporte Básico Sin soporte 47 15.0 (15.0) Sin soporte Sin soporte Sin soporte 47

Ver también

Etiquetas y colaboradores del documento

 Colaboradores en esta página: deluxury, lacf95, angelcuenca, mikicegal14
 Última actualización por: deluxury,