В процессе перевода.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Syntax
Для вызовов функций:
myFunction(...iterableObj);
Для литералов массива или строк:
[...iterableObj, '4', 'five', 6];
Для литералов объекта (новое в ECMAScript 2018):
let objClone = { ...obj };
Примеры
Spread в вызовах функций
Replace apply
Обычно используют Function.prototype.apply в случаях, когда хотят использовать элементы массива в качестве аргументов функции.
function myFunction(x, y, z) { }
var args = [0, 1, 2];
myFunction.apply(null, args);
С spread syntax вышеприведенное можно записать как:
function myFunction(x, y, z) { }
var args = [0, 1, 2];
myFunction(...args);
Любой аргумент в списке аргументов может использовать spread syntax, и его можно использовать несколько раз.
function myFunction(v, w, x, y, z) { }
var args = [0, 1];
myFunction(-1, ...args, 2, ...[3]);
Apply for new
When calling a constructor with new, it's not possible to directly use an array and apply (apply does a [[Call]] and not a [[Construct]]). However, an array can be easily used with new thanks to spread syntax:
var dateFields = [1970, 0, 1]; // 1 Jan 1970 var d = new Date(...dateFields);
To use new with an array of parameters without spread syntax, you would have to do it indirectly through partial application:
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"}
Spread in array literals
A more powerful array literal
Without spread syntax, to create a new array using an existing array as one part of it, the array literal syntax is no longer sufficient and imperative code must be used instead using a combination of push, splice, concat, etc. With spread syntax this becomes much more succinct:
var parts = ['shoulders', 'knees']; var lyrics = ['head', ...parts, 'and', 'toes']; // ["head", "shoulders", "knees", "and", "toes"]
Just like spread for argument lists, ... can be used anywhere in the array literal and it can be used multiple times.
Copy an array
var arr = [1, 2, 3]; var arr2 = [...arr]; // like arr.slice() arr2.push(4); // arr2 becomes [1, 2, 3, 4] // arr remains unaffected
Note: Spread syntax effectively goes one level deep while copying an array. Therefore, it may be unsuitable for copying multidimensional arrays as the following example shows (it's the same with Object.assign() and spread syntax).
var a = [[1], [2], [3]]; var b = [...a]; b.shift().shift(); // 1 // Now array a is affected as well: [[], [2], [3]]
A better way to concatenate arrays
Array.concat is often used to concatenate an array to the end of an existing array. Without spread syntax this is done as:
var arr1 = [0, 1, 2]; var arr2 = [3, 4, 5]; // Append all items from arr2 onto arr1 arr1 = arr1.concat(arr2);
With spread syntax this becomes:
var arr1 = [0, 1, 2]; var arr2 = [3, 4, 5]; arr1 = [...arr1, ...arr2];
Array.unshift is often used to insert an array of values at the start of an existing array. Without spread syntax this is done as:
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]
With spread syntax this becomes [Note, however, that this creates a new arr1 array. Unlike Array.unshift, it does not modify the original arr1 array in-place]:
var arr1 = [0, 1, 2]; var arr2 = [3, 4, 5]; arr1 = [...arr2, ...arr1]; // arr1 is now [3, 4, 5, 0, 1, 2]
Spread in object literals
The Rest/Spread Properties for ECMAScript proposal (stage 4) adds spread properties to object literals. It copies own enumerable properties from a provided object onto a new object.
Shallow-cloning (excluding prototype) or merging of objects is now possible using a shorter syntax than 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 }
Note that Object.assign() triggers setters whereas spread syntax doesn't.
Note that you cannot replace nor mimic the Object.assign() function:
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 } }
In the above example, the spread operator does not work as one might expect: it spreads an array of arguments into the object literal, due to the rest parameter.
Only for iterables
Spread syntax (other than in the case of spread properties) can be applied only to iterable objects:
var obj = {'key1': 'value1'};
var array = [...obj]; // TypeError: obj is not iterable
Spread with many values
When using spread syntax for function calls, be aware of the possibility of exceeding the JavaScript engine's argument length limit. See apply() for more details.
Rest syntax (parameters)
Rest syntax looks exactly like spread syntax, but is used for destructuring arrays and objects. In a way, rest syntax is the opposite of spread syntax: spread 'expands' an array into its elements, while rest collects multiple elements and 'condenses' them into a single element. See rest parameters.
Specifications
| Specification | Status | Comment |
|---|---|---|
| ECMAScript 2015 (6th Edition, ECMA-262) | Стандарт | Defined in several sections of the specification: Array Initializer, Argument Lists |
| ECMAScript 2018 (ECMA-262) | Стандарт | Defined in Object Initializer |
| ECMAScript Latest Draft (ECMA-262) | Черновик | No changes. |
| ECMAScript Latest Draft (ECMA-262) | Черновик | No changes. |
Browser compatibility
| Компьютеры | Мобильные | Server | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Spread in array literals | Chrome Полная поддержка 46 | Edge Полная поддержка 12 | Firefox Полная поддержка 16 | IE Нет поддержки Нет | Opera Полная поддержка 37 | Safari Полная поддержка 8 | WebView Android Полная поддержка 46 | Chrome Android Полная поддержка 46 | Edge Mobile Полная поддержка 12 | Firefox Android Полная поддержка 16 | Opera Android Полная поддержка 37 | Safari iOS Полная поддержка 8 | Samsung Internet Android Полная поддержка 5.0 | nodejs
Полная поддержка
5.0.0
|
| Spread in function calls | Chrome Полная поддержка 46 | Edge Полная поддержка 12 | Firefox Полная поддержка 27 | IE Нет поддержки Нет | Opera Полная поддержка 37 | Safari Полная поддержка 8 | WebView Android Полная поддержка 46 | Chrome Android Полная поддержка 46 | Edge Mobile Полная поддержка 12 | Firefox Android Полная поддержка 27 | Opera Android Полная поддержка 37 | Safari iOS Полная поддержка 8 | Samsung Internet Android Полная поддержка 5.0 | nodejs
Полная поддержка
5.0.0
|
| Spread in destructuring | Chrome Полная поддержка 49 | Edge Нет поддержки Нет | Firefox Полная поддержка 34 | IE Нет поддержки Нет | Opera Полная поддержка 37 | Safari ? | WebView Android Полная поддержка 49 | Chrome Android Полная поддержка 49 | Edge Mobile Нет поддержки Нет | Firefox Android Полная поддержка 34 | Opera Android Полная поддержка 37 | Safari iOS ? | Samsung Internet Android Полная поддержка 5.0 | nodejs Полная поддержка Да |
| Spread in object literals | Chrome Полная поддержка 60 | Edge Нет поддержки Нет | Firefox Полная поддержка 55 | IE Нет поддержки Нет | Opera ? | Safari Нет поддержки Нет | WebView Android Полная поддержка 60 | Chrome Android Полная поддержка 60 | Edge Mobile Нет поддержки Нет | Firefox Android Полная поддержка 55 | Opera Android ? | Safari iOS Нет поддержки Нет | Samsung Internet Android Нет поддержки Нет | nodejs
Полная поддержка
8.3.0
|
Легенда
- Полная поддержка
- Полная поддержка
- Нет поддержки
- Нет поддержки
- Совместимость неизвестна
- Совместимость неизвестна
- Экспериментальная. Ожидаемое поведение может измениться в будущем.
- Экспериментальная. Ожидаемое поведение может измениться в будущем.
- Пользователь должен сам включить эту возможность.
- Пользователь должен сам включить эту возможность.
See also
- Rest parameters (also ‘
...’) - fn.apply (also ‘
...’)