Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Destrukturyzacja obiektów i wartości iterowalnych

Destrukturyzacja (destructuring) odczytuje właściwości obiektu lub kolejne wartości z obiektu iterowalnego za pomocą wzorca. Umożliwia deklarowanie zmiennych, przypisywanie do istniejących zmiennych, zmianę nazw, wartości domyślne i zbieranie reszty.

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

const { key: localName = fallback, ...rest } = object;
const [first, , third = fallback, ...tail] = iterable;
({ key: existingVariable } = object);

Destrukturyzacja (destructuring) to składnia wzorców, a nie funkcja ani słowo kluczowe. Wzorzec { key } odczytuje właściwość według klucza, a [first] pobiera wartość z iteratora — źródło nie musi być tablicą. Wzorce można zagnieżdżać i stosować także w parametrach funkcji.

Deklaracja const { key: localName = fallback } = object tworzy localName, nie key. Wartość domyślna jest obliczana tylko wtedy, gdy odczytana wartość to undefined, również przy braku właściwości; null, 0 i false jej nie uruchamiają. Destrukturyzacja null lub undefined zgłasza TypeError; wzorzec tablicowy wymaga wartości iterowalnej.

Przecinek we wzorcu tablicowym pozwala pominąć pozycję. Końcowe ...tail zbiera pozostałe wartości iteratora do nowej tablicy; ...rest we wzorcu obiektowym kopiuje pozostałe własne, wyliczalne właściwości do nowego obiektu. Rest musi być ostatni, bez przecinka po nim. Nie jest to głębokie kopiowanie: zagnieżdżone obiekty pozostają współdzielonymi referencjami.

Deklaracja tworzy wiązania, natomiast przypisanie aktualizuje istniejące cele. Gdy przypisanie obiektowe zaczyna instrukcję, użyj nawiasów: ({ key: existingVariable } = object);, aby { nie rozpoczynało bloku. W przykładzie userName otrzymuje "Ada", a wartości undefined uruchamiają wartości domyślne.

Przykłady

const record = { name: "Ada", score: undefined, active: true };
const { name: userName, score = 10, ...rest } = record;
const [first, , third = 9, ...tail] = [2, 4, undefined, 8];
console.log(`${userName}|${score}|${rest.active}|${first}|${third}|${tail.join(",")}`);

Wynik

Ada|10|true|2|9|8

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła