CKTIS / JavaScript
Składnia spread i rest (...)
Zapis `...` ma dwie role zależne od kontekstu: spread rozwija wartości lub właściwości, a rest zbiera pozostałe argumenty, elementy albo właściwości. Nie jest samodzielnym operatorem wyrażeniowym. Kopiowanie za jego pomocą jest płytkie.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
fn(...iterable)
[...iterable]
({ ...source })
function fn(first, ...args) {}
const [first, ...tail] = iterable;
const { key, ...remaining } = source;... oznacza składnię spread albo rest, zależnie od miejsca użycia; nie jest samodzielnym operatorem wyrażeniowym. Spread w fn(...iterable) przekazuje wartości jako argumenty, a w [...iterable] umieszcza je w nowej tablicy. Źródło musi być iterowalne: zwykły obiekt nie wystarcza. Bardzo duże rozwinięcia argumentów mogą przekroczyć limit silnika.
Spread w { ...source } kopiuje własne, wyliczalne właściwości, w tym klucze typu Symbol; nie wymaga iterowalności. Późniejsze definicje nadpisują wcześniejsze wartości tego samego klucza. Nie kopiuje prototypu ani deskryptorów, a odczyt właściwości może uruchamiać gettery. Źródła null i undefined są tutaj pomijane, ale [...null] powoduje TypeError.
Rest w function fn(first, ...args) {} zbiera pozostałe argumenty do rzeczywistej tablicy. W destrukturyzacji const [first, ...tail] = iterable zbiera pozostałe wartości iteratora do tablicy, a const { key, ...remaining } = source tworzy obiekt z pozostałych własnych, wyliczalnych właściwości. Rest musi być ostatni na swojej liście i nie może mieć końcowego przecinka; parametr rest nie może mieć wartości domyślnej.
Kopie są płytkie: zagnieżdżone obiekty pozostają współdzielone. Przykład pokazuje rozwijanie, zbieranie i współdzielenie settings. Składnia rest parametrów, rest tablic oraz spread tablic i argumentów pochodzi z ES2015; rest/spread obiektów z ES2018. Są to funkcje ECMAScript, nie Web APIs. Specyfikacja nie jest tabelą zgodności przeglądarek; obsługę konkretnej przeglądarki należy sprawdzić oddzielnie, a obecność Node 24 w repozytorium jej nie dowodzi.
Przykłady
function sum(...values) {
return values.reduce((total, value) => total + value, 0);
}
const numbers = [2, 3, 4];
const [first, ...tail] = numbers;
const original = { name: "Ada", settings: { active: true } };
const copy = { ...original, name: "Lin" };
const { name, ...remaining } = copy;
console.log(sum(...numbers));
console.log(JSON.stringify([first, ...tail, 5]));
console.log(name, remaining.settings === original.settings);Wynik
9 [2,3,4,5] Lin true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.