La sintaxis extendida o spreadsyntax permite a un elemento iterable tal como un arreglo o cadena ser expandido en lugares donde cero o más argumentos (para llamadas de función) o elementos (paraArray literales) son esperados, o a un objeto ser expandido en lugares donde cero o más pares de valores clave (paraliterales Tipo Objeto) son esperados.

Pruébalo

function sum(x, y, z) {  return x + y + z;}const numbers = [1, 2, 3];console.log(sum(...numbers));// Expected output: 6console.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 función

Reemplaza "apply"

Es frecuente usarFunction.prototype.apply en casos donde quieres usar los elementos de un arreglo como argumentos de una función.

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

Con la sintaxis expandida (spread syntax), el código 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 sintáxis 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 connew, no es posible usardirectamente un arreglo yapply (apply hace un[[Call]] y no un[[Construct]]). Sin embargo, un arreglo puede ser fácilmente usado con un new gracias a la sintáxis expandida:

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

Para usarnew con un arreglo de parámetros sin la sintáxis expandida, podrías tener que hacerloindirectamente a través de una aplicación 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 más poderoso

Sinsintaxis 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 código imperativo con una combinación depush,splice,concat, etc. Con la sintaxis expandida, esto se vuelve mucho mas práctico:

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 múltiples 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 conObject.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 arr1arr1 = 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 sintáxis spread, esto es hecho como:

var arr1 = [0, 1, 2];var arr2 = [3, 4, 5];// Prepend all items from arr2 onto arr1Array.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 arregloarr1. Diferente aArray.unshift, esto no modifica el arreglo original en sitioarr1]:

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 propuestaPropiedades Rest/Spread para ECMAScript (etapa 4) agrega propiedades spread a losliterales Tipo Objeto. Esto copia sus propiedades enumerables desde un objeto provisto dentro de un nuevo objeto.

Shallow-cloning (excluyendo prototype) o la combinación de objetos es ahora posible usando una sintaxis más corta queObject.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 queObject.assign() desencadenasetters mientras que la sintaxis spread no lo hace.

Observa que tú no puedes reemplazar o replicar la funciónObject.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 podría esperar: este dispersa unarreglo de argumentos en el literal Tipo Objeto, debido al parámetro rest.

Sólo para iterables

La sintaxis Spread (otra que en el caso de las propiedades spread) puede ser aplicada sólo a los objetositerables:

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 límite de longitud de argumentos del motor de JavaScript. Veaapply() para más detalles.

Sintaxis Rest (parámetros)

La sintaxis Rest luce exactamente como la sintaxis spread, pero esto es usado por la desestructuración 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 múltiples elementos y los 'condensa' en un único elemento. Consultaparámetros rest.

Especificaciones

Compatibilidad con navegadores

Vea también

• Rest parameters (también '...')