Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła