Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Destrukturyzacja obiektu, wartości domyślne parametrów i skrócony zapis właściwości

Odczytuj opcje z jednego argumentu, rozróżniaj wartość domyślną całego parametru od wartości domyślnych właściwości i buduj wynik za pomocą skróconego zapisu właściwości.

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

Składnia

function configure({ limit: maxItems = 10, enabled = true } = {}) {
  return { maxItems, enabled };
}

W nagłówku funkcji configure zapis { limit: maxItems = 10, enabled = true } jest wzorcem destrukturyzacji. Funkcja przyjmuje jeden argument pozycyjny, a nie argumenty nazwane. Wzorzec odczytuje właściwość limit do lokalnej zmiennej maxItems, a właściwość enabled do zmiennej o tej samej nazwie.

Zewnętrzne = {} tworzy nowy pusty obiekt, gdy argument pominięto lub przekazano undefined. Wewnętrzne = 10 i = true działają niezależnie, tylko gdy odczyt danej właściwości daje undefined, również wtedy, gdy nie znaleziono właściwości. Wartości null, 0, false i "" we właściwościach pozostają bez zmian. Natomiast configure(null) zgłasza TypeError przed wykonaniem ciała funkcji. Bez zewnętrznego = {} pominięcie argumentu również powodowałoby TypeError.

Wyrażenia domyślne są obliczane podczas wywołania i tylko w razie potrzeby. Mogą korzystać z wcześniej zainicjalizowanych parametrów, ale nie z deklaracji wewnątrz ciała funkcji. Odczyt właściwości może sięgnąć do łańcucha prototypów lub wywołać getter, więc sam wzorzec nie sprawdza typu wartości ani tego, czy właściwość należy bezpośrednio do obiektu.

W return { maxItems, enabled } klamry oznaczają literał nowego obiektu, a nie wzorzec. Skrócony zapis właściwości daje tu taki sam efekt jak { maxItems: maxItems, enabled: enabled }: klucze pochodzą od nazw lokalnych, więc wynik ma klucz maxItems, a nie limit. To składnia ECMAScript opisana w wydaniu z 2024 r.; sprawdź jej obsługę w starszych środowiskach, które chcesz wspierać.

Przykłady

function configure({ limit: maxItems = 10, enabled = true } = {}) {
  return { maxItems, enabled };
}

console.log(JSON.stringify(configure()));
console.log(JSON.stringify(configure(undefined)));
console.log(JSON.stringify(configure({ limit: 0, enabled: false })));
console.log(JSON.stringify(configure({ limit: undefined, enabled: null })));

try {
  configure(null);
} catch (error) {
  console.log(error.name);
}

Wynik

{"maxItems":10,"enabled":true}
{"maxItems":10,"enabled":true}
{"maxItems":0,"enabled":false}
{"maxItems":10,"enabled":null}
TypeError

Pierwsze dwa wywołania dają identyczny wynik. Trzecie zachowuje `0` i `false`, czwarte zastępuje tylko `undefined`, a ostatnie wypisuje `TypeError`, ponieważ cały argument to `null`.

Powiązane lekcje

  • JavaScript · Lekcja 42 · Zaawansowany · Wersja: 4

Źródła