Esta página ha sido traducida del inglés por la comunidad.Aprende más y únete a la comunidad de MDN Web Docs.
Parámetros Rest
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since septiembre de 2016.
La sintaxis de losparámetros rest nos permiten representar un número indefinido de argumentos como un array.
Pruébalo
function sum(...theArgs) { let total = 0; for (const arg of theArgs) { total += arg; } return total;}console.log(sum(1, 2, 3));// Expected output: 6console.log(sum(1, 2, 3, 4));// Expected output: 10Sintaxis
function(a, b, ...theArgs) { // ...}Descripción
El último parámetro de una función se puede prefijar con..., lo que hará que todos los argumentos restantes (suministrados por el usuario) se coloquen dentro de un array de javascript "estándar".
Sólo el último parámetro puede ser un "parámetro rest".
function myFun(a, b, ...manyMoreArgs) { console.log("a", a); console.log("b", b); console.log("manyMoreArgs", manyMoreArgs);}myFun("one", "two", "three", "four", "five", "six");// Console Output:// a, one// b, two// manyMoreArgs, [three, four, five, six]Diferencia entre los parámetros rest y el objetoarguments
Hay tres principales diferencias entre los parámetros rest y el objetoarguments:
- los parámetros rest son sólo aquellos a los que no se les ha asignado un nombre, mientras que el objeto
argumentscontiene todos los argumentos que se le han pasado a la función; - el objeto
argumentsno es un array real, mientras que los parámetros rest son instancias deArray, lo que significa que lo los métodos comosort,map,forEachopoppueden aplicarse directamente; - el objeto
argumentstiene una funcionalidad adicional específica para sí mismo (como la propiedadcallee).
De argumentos a array
Los parámetros rest han sido agregados para reducir el código repetitivo que se usaba en los parámetros.
// Antes de los parámetros rest, "arguments" se podía convertir en un array usando:function f(a, b) { let normalArray = Array.prototype.slice.call(arguments); // -- o -- let normalArray = [].slice.call(arguments); // -- o -- let normalArray = Array.from(arguments); let first = normalArray.shift(); // OK, nos da el primer argumento let first = arguments.shift(); // ERROR (arguments no es un array)}// Ahora, puedes acceder fácilmente a un array usando un parametro rest.function f(...args) { let normalArray = args; let first = normalArray.shift(); // OK, gives the first argument}Desestructuración de los parametros rest
Los parámetros rest pueden ser desestructurados, eso significa que sus datos pueden ser desempaquetados dentro de distintas variables. VerDestructuring assignment.
function f(...[a, b, c]) { return a + b + c;}f(1); // NaN (b y c son indefinidos)f(1, 2, 3); // 6f(1, 2, 3, 4); // 6 (el cuarto parámetro no está desestructurado)Ejemplos
Usando parámetros rest
En este ejemplo, el primer argumento es mapeado con 'a' y el segundo con 'b', entonces, esos argumentos nombrados, son usados normalmente
De todas formas, el tercer argumento,manyMoreArgs, será un array que contendrá tantos argumentos como el usuario incluya (3er, 4to, 5to ...).
function myFun(a, b, ...manyMoreArgs) { console.log("a", a); console.log("b", b); console.log("manyMoreArgs", manyMoreArgs);}myFun("one", "two", "three", "four", "five", "six");// a, one// b, two// manyMoreArgs, [three, four, five, six]Debajo... incluso si hay solo un valor, el ultimo argumento seguirá siendo colocado dentro de un array.
// usando la misma definición de función del ejemplo anteriormyFun("one", "two", "three");// a, one// b, two// manyMoreArgs, [three]Debajo, el tercer argumento no esta provisto, peromanyMoreArgs continúa siendo un array (aunque uno vacío).
//usando la misma definición de función del ejemplo anteriormyFun("one", "two");// a, one// b, two// manyMoreArgs, []Argument length
Puesto quetheArgs es un array, su tamaño (un conteo de sus elementos) es dado por la propiedadlength :
function fun1(...theArgs) { console.log(theArgs.length);}fun1(); // 0fun1(5); // 1fun1(5, 6, 7); // 3Ordinary parameter and rest parameters
En el siguiente ejemplo, se usa un parámetro rest para agrupar dentro de un array a todos los argumentos despues del primero. Luego cada uno es multiplicado por el primero y el arreglo es retornado:
function multiply(multiplier, ...theArgs) { return theArgs.map(function (element) { return multiplier * element; });}let arr = multiply(2, 1, 2, 3);console.log(arr); // [2, 4, 6]El siguiente ejemplo muestra que se puede usar los métodos deArray en los parámetros rest , pero no en el objetoarguments:
function sortRestArgs(...theArgs) { var sortedArgs = theArgs.sort(); return sortedArgs;}console.log(sortRestArgs(5, 3, 7, 1)); // muestra 1,3,5,7function sortArguments() { var sortedArgs = arguments.sort(); return sortedArgs; // esto nunca va a ocurrir}// lanza un TypeError: arguments.sort is not a functionconsole.log(sortArguments(5, 3, 7, 1));Para poder usar los métodos deArray en el objetoarguments, se debe convertir a unArray primero.
Especificaciones
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-function-definitions |