Оператор расширения

Сводка

Оператор расширения позволяет расширять выражения в тех местах, где предусмотрено использование нескольких аргументов (при вызовах функции) или ожидается несколько элементов (для массивов).

Синтаксис

При вызовах функции:

f(...iterableObj);

В литералах массива:

[...iterableObj, 4, 5, 6]

При деструктивном присваивании:

[a, b, ...iterableObj] = [1, 2, 3, 4, 5];

Примеры

Улучшенная версия apply

Пример: очень широко используется Function.prototype.apply при необходимости передачи массива аргументов в функцию:

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

При помощи оператора разворота ES6 вы можете использовать следующий эквивалент:

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

Оператор может использоваться для любого аргумента, в том числе и несколько раз:

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

Удобные литералы массивов

Пример: в настоящий момент, если у вас есть массив и вы хотите создать из его части новый массив, то синтаксис литералов вам не поможет и придётся использовать императивный подход с комбинацией push, splice, concat и т.п. При помощи оператора расширения это можно сделать проще:

var parts = ['плечи', 'колени'];
var lyrics = ['голова', ...parts, 'и', 'пальцы']; // ["голова", "плечи", "колени", "и", "пальцы"]

Также как и в случае со списком аргументов функции ... может быть использован в любом месте определения массива, в том числе и многократно.

Подходит для new

Пример: в ES5 невозможно выполнить комбинацию new и apply (в терминах ES5 apply выполняет вызов метода, а не конструктора). В ES6 оператор разворота поддерживает это:

var dateFields = readDateFields(database);
var d = new Date(...dateFields);

Улучшенная версия push

Пример: push часто используется для добавления элементов в конец массива. В ES5 это выглядит следующим образом:

var arr1 = [0, 1, 2];
var arr2 = [3, 4, 5];
// Добавить все элементы из массива arr2 в arr1
Array.prototype.push.apply(arr1, arr2);

В ES6 при использовании оператора разворота это становится:

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

Применяется только для простых массивов

var obj = {"key1":"value1"};
function myFunction(x) {
    console.log(x); // undefined
}
myFunction(...obj);
var args = [...obj];
console.log(args, args.length) //[] 0

Спецификации

Совместимость с браузерами

Смотрите также

• Оставшиеся параметры