Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Destrukturyzacja obiektów

Destrukturyzacja obiektów odczytuje właściwości według kluczy, a nie według pozycji. Pozwala tworzyć zmienne, przypisywać wartości do istniejących celów, 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 { name, theme: colorTheme = "light", ...rest } = profile;
let score;
({ points: score } = profile);
const { [key]: value, settings: { mode } = {} } = options;
function readName({ name = "Guest" } = {}) { return name; }

Destrukturyzacja obiektów używa wzorca w {} do odczytu właściwości według kluczy. W const { name } = profile zmienna name otrzymuje wartość profile.name. Zapis { name: displayName } odczytuje ten sam klucz, ale nadaje zmiennej nazwę displayName; nie zmienia nazwy właściwości. Zapis { [key]: value } oblicza klucz, a { settings: { mode } } odczytuje zagnieżdżoną właściwość i wiąże tylko mode.

W deklaracji z const, let lub var oraz w parametrze funkcji wzorzec tworzy wiązania. Przypisanie ({ points: score } = profile) zapisuje wartość w istniejącej zmiennej score; celem może być też zapisywalna właściwość. W samodzielnej instrukcji nawiasy zapobiegają odczytaniu początkowego { jako początku bloku.

W { theme = "light" } wyrażenie domyślne jest obliczane tylko wtedy, gdy odczyt zwróci undefined, na przykład gdy nie znaleziono właściwości. Wartości null, false i 0 pozostają bez zmian. Jeśli sam wzorzec próbuje odczytać właściwości z null lub undefined, wystąpi TypeError, także przy zagnieżdżeniu. W function readName({ name = "Guest" } = {}) zapis = {} obsługuje pominięty argument lub undefined, ale nie null.

Odczyt wskazanego klucza może znaleźć właściwość odziedziczoną. Natomiast ...rest płytko kopiuje do nowego obiektu tylko pozostałe własne, wyliczalne właściwości, także te o kluczach typu Symbol. Obiekty będące wartościami nadal są współdzielone. ...rest musi być na końcu wzorca, bez przecinka po nim.

To składnia ECMAScript 2024, a nie API przeglądarki. W starszych środowiskach JavaScript sprawdź obsługę używanych form, zwłaszcza ...rest.

Przykłady

{
  const profile = { name: "Mira", theme: undefined, badge: null, points: 7 };
  const { name: displayName, theme = "light", badge = "none", ...rest } = profile;
  let score;
  ({ points: score } = profile);
  console.log(`${displayName} | ${theme} | ${badge} | ${score} | ${Object.keys(rest).join(",")}`);
}

Wynik

Mira | light | null | 7 | points

`displayName` otrzymuje wartość `name`, `theme` przyjmuje wartość domyślną, a `badge` pozostaje `null`. Przypisanie zapisuje `7` w `score`; `points` to jedyny klucz w `rest`.

Powiązane lekcje

  • JavaScript · Lekcja 39 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 5 · Podstawowy · Wersja: 4
  • JavaScript · Lekcja 18 · Podstawowy · Wersja: 4
  • JavaScript · Lekcja 2 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 8 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 10 · Średniozaawansowany · Wersja: 3

Źródła