Sintaxis Spread

Prubalo

function sum(x, y, z) {
  return x + y + z;
}

const numbers = [1, 2, 3];

console.log(sum(...numbers));
// Expected output: 6

console.log(sum.apply(null, numbers));
// Expected output: 6

Sintaxis

Para llamadas de funciones:

myFunction(...iterableObj);

Para arreglos literales o cadenas de caracteres:

[...iterableObj, '4', 'five', 6];

Para objetos literales (nuevo en ECMAScript 2018):

let objClone = { ...obj };

Ejemplos

Spread en llamadas de funcin

Reemplaza "apply"

Es frecuente usar Function.prototype.apply en casos donde quieres usar los elementos de un arreglo como argumentos de una funcin.

function myFunction(x, y, z) {}
var args = [0, 1, 2];
myFunction.apply(null, args);

Con la sintaxis expandida (spread syntax), el cdigo anterior puede ser escrito como:

function myFunction(x, y, z) {}
var args = [0, 1, 2];
myFunction(...args);

Cualquier argumento en la lista de argumentos puede usar la sintxis expandida y esto puede ser usado varias veces.

function myFunction(v, w, x, y, z) {}
var args = [0, 1];
myFunction(-1, ...args, 2, ...[3]);

"Apply" para "new"

Cuando se llama un constructor con new, no es posible usar directamente un arreglo y apply (apply hace un [[Call]] y no un [[Construct]]). Sin embargo, un arreglo puede ser fcilmente usado con un new gracias a la sintxis expandida:

var dateFields = [1970, 0, 1]; // 1 Jan 1970
var d = new Date(...dateFields);

Para usar new con un arreglo de parmetros sin la sintxis expandida, podras tener que hacerlo indirectamente a travs de una aplicacin parcial:

function applyAndNew(constructor, args) {
  function partial() {
    return constructor.apply(this, args);
  }
  if (typeof constructor.prototype === "object") {
    partial.prototype = Object.create(constructor.prototype);
  }
  return partial;
}

function myConstructor() {
  console.log("arguments.length: " + arguments.length);
  console.log(arguments);
  this.prop1 = "val1";
  this.prop2 = "val2";
}

var myArguments = ["hi", "how", "are", "you", "mr", null];
var myConstructorWithArguments = applyAndNew(myConstructor, myArguments);

console.log(new myConstructorWithArguments());
// (internal log of myConstructor):           arguments.length: 6
// (internal log of myConstructor):           ["hi", "how", "are", "you", "mr", null]
// (log of "new myConstructorWithArguments"): {prop1: "val1", prop2: "val2"}

Expandir Array literales

Un literal Array ms poderoso

Sin sintaxis expandida (spread syntax), para crear un nuevo arreglo usando un arreglo existente como parte de l,no es suficiente la sintaxis de Array literal y en su lugar se debe usar cdigo imperativo con una combinacin de push, splice, concat, etc. Con la sintaxis expandida, esto se vuelve mucho mas prctico:

var parts = ["shoulders", "knees"];
var lyrics = ["head", ...parts, "and", "toes"];
// ["head", "shoulders", "knees", "and", "toes"]

As como para expandir listas de argumentos, ... puede ser usado en cualquier parte dentro del Array literal, y mltiples veces.

Copiar un arreglo

var arr = [1, 2, 3];
var arr2 = [...arr]; // like arr.slice()
arr2.push(4);

// arr2 becomes [1, 2, 3, 4]
// arr remains unaffected

Nota: La sintaxis expandida efectivamente va a un nivel de profundidad mientras copia un arreglo. Por lo tanto, esto no permite copiar arreglos multidimensionales como se muestra en los siguientes ejemplos (es lo mismo con Object.assign() y sintaxis spread).

var a = [[1], [2], [3]];
var b = [...a];
b.shift().shift(); // 1
// Now array a is affected as well: [[], [2], [3]]

Una forma mejor para concatenar arreglos

Array.concat es usada a menudo para concatenar un arreglo al final de un arreglo ya existente. Sin la sintaxis spread se realiza:

var arr1 = [0, 1, 2];
var arr2 = [3, 4, 5];
// Append all items from arr2 onto arr1
arr1 = arr1.concat(arr2);

Con la sintaxis spread se transforma en:

var arr1 = [0, 1, 2];
var arr2 = [3, 4, 5];
arr1 = [...arr1, ...arr2];

Array.unshift es a menudo usada para insertar un arreglo de valores al inicio de un arreglo existente. Sin la sintxis spread, esto es hecho como:

var arr1 = [0, 1, 2];
var arr2 = [3, 4, 5];
// Prepend all items from arr2 onto arr1
Array.prototype.unshift.apply(arr1, arr2); // arr1 is now [3, 4, 5, 0, 1, 2]

Con la sintaxis spread se convierte en [Observa, sin embargo, que esto crea un nuevo arreglo arr1. Diferente a Array.unshift, esto no modifica el arreglo original en sitio arr1]:

var arr1 = [0, 1, 2];
var arr2 = [3, 4, 5];
arr1 = [...arr2, ...arr1]; // arr1 is now [3, 4, 5, 0, 1, 2]

Spread en literales tipo Objeto

La propuesta Propiedades Rest/Spread para ECMAScript (etapa 4) agrega propiedades spread a los literales Tipo Objeto. Esto copia sus propiedades enumerables desde un objeto provisto dentro de un nuevo objeto.

Shallow-cloning (excluyendo prototype) o la combinacin de objetos es ahora posible usando una sintaxis ms corta que Object.assign().

var obj1 = { foo: "bar", x: 42 };
var obj2 = { foo: "baz", y: 13 };

var clonedObj = { ...obj1 };
// Object { foo: "bar", x: 42 }

var mergedObj = { ...obj1, ...obj2 };
// Object { foo: "baz", x: 42, y: 13 }

Observa que Object.assign() desencadena setters mientras que la sintaxis spread no lo hace.

Observa que t no puedes reemplazar o replicar la funcin Object.assign():

var obj1 = { foo: "bar", x: 42 };
var obj2 = { foo: "baz", y: 13 };
const merge = (...objects) => ({ ...objects });

var mergedObj = merge(obj1, obj2);
// Object { 0: { foo: 'bar', x: 42 }, 1: { foo: 'baz', y: 13 } }

var mergedObj = merge({}, obj1, obj2);
// Object { 0: {}, 1: { foo: 'bar', x: 42 }, 2: { foo: 'baz', y: 13 } }

En el ejemplo de arriba, el operador spread no trabaja como uno podra esperar: este dispersa un arreglo de argumentos en el literal Tipo Objeto, debido al parmetro rest.

Slo para iterables

La sintaxis Spread (otra que en el caso de las propiedades spread) puede ser aplicada slo a los objetos iterables:

var obj = { key1: "value1" };
var array = [...obj]; // TypeError: obj is not iterable

Spread con muchos valores

Cuando se usa la sintaxis spread para llamados de funciones, tenga en cuenta la posibilidad de exceder el lmite de longitud de argumentos del motor de JavaScript. Vea apply() para ms detalles.

Sintaxis Rest (parmetros)

La sintaxis Rest luce exactamente como la sintaxis spread, pero esto es usado por la desestructuracin de arreglos y objetos. De cierta forma, la sintaxis rest es la opuesta a la sintaxis spread: spread 'expande' un arreglo en sus elementos, mientras rest agrupa mltiples elementos y los 'condensa' en un nico elemento. Consulta parmetros rest.

Especificaciones

Compatibilidad con navegadores

Vea tambin

• Rest parameters (tambin '...')