Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Deklaracja z destrukturyzacją obiektu

Deklaracja z destrukturyzacją obiektu tworzy wiązania zmiennych na podstawie właściwości źródła. Wzorzec pozwala nadawać inne nazwy, ustawiać wartości domyślne i zbierać pozostałe właściwości.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

const { property, key: local = fallback, [computedKey]: selected, nested: { inner } = {}, ...rest } = source;
let { property: mutable } = source;
var { property: variable } = source;

W zwykłej deklaracji const { property } = source; klamry zawierają wzorzec wiązania, a nie literał obiektu. Wyrażenie source jest obowiązkowym inicjalizatorem. const i let mają zakres blokowy; const zabrania ponownego przypisania do wiązania, ale nie zamraża obiektu. var użyte w funkcji ma zakres tej funkcji, nie bloku.

{ key: local } odczytuje key i deklaruje local, nie key. { [computedKey]: selected } oblicza klucz, a zagnieżdżony wzorzec odczytuje właściwości na kolejnym poziomie. Wartość domyślna jest obliczana tylko wtedy, gdy odczyt zwraca undefined, na przykład przy braku właściwości. Nie zastępuje null, false ani 0. Destrukturyzacja null lub undefined zgłasza TypeError, także we wzorcu zagnieżdżonym.

Jawnie wskazana właściwość może pochodzić z prototypu. ...rest płytko kopiuje do nowego obiektu tylko pozostałe własne właściwości wyliczalne, także te o kluczach typu Symbol. Musi być ostatnie, zawierać nazwę wiązania i nie może mieć po sobie przecinka. Destrukturyzacja nie sprawdza poprawności danych; odczyt właściwości może uruchomić getter.

({ property } = source); jest przypisaniem do istniejącej zmiennej, a nie deklaracją. Nawiasy sprawiają, że na początku instrukcji { nie zostanie odczytane jako początek bloku. Opisaną składnię definiuje ECMAScript 2024; sprawdź jej obsługę w docelowym środowisku wykonawczym.

Przykłady

{
  const key = "theme";
  const source = { name: "Ada", theme: null, active: false };
  const {
    name: displayName,
    [key]: theme = "light",
    settings: { density = "compact" } = {},
    ...rest
  } = source;

  console.log(JSON.stringify([displayName, theme, density, rest]));
}

Wynik

["Ada",null,"compact",{"active":false}]

`name` trafia do `displayName`, a `theme` zachowuje `null`. Brak `settings` uruchamia wartość domyślną `{}`, po czym `density` przyjmuje `"compact"`. W `rest` zostaje tylko `active: false`.

Powiązane lekcje

  • JavaScript · Lekcja 1 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 8 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 11 · Zaawansowany · Wersja: 4

Źródła