Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Destrukturyzacja tablic w parametrach funkcji

Wzorzec tablicowy w liście parametrów rozpakowuje jeden argument iterowalny. Wartości domyślne argumentu i poszczególnych elementów działają niezależnie.

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

Składnia

function f([first = 1, , third = 3, ...rest] = []) { /* function body */ }

W liście parametrów funkcji [first, third] to tablicowy wzorzec wiązania dla jednego argumentu, a nie dwa osobne parametry. Przy wywołaniu funkcji wartości z argumentu są przypisywane do lokalnych nazw w kolejności iteracji, zanim wykona się ciało funkcji. Można przekazać tablicę lub inny obiekt iterowalny, np. Set; zwykły obiekt z kluczami liczbowymi i właściwością length nie wystarczy.

W [first = 1, , third = 3, ...rest] puste miejsce między przecinkami pomija drugą wartość. ...rest zbiera pozostałe wartości do nowej tablicy. To element resztowy we wzorcu, a nie parametr resztowy zbierający osobne argumenty wywołania. Musi być ostatni i nie może po nim wystąpić przecinek.

Zewnętrzne = [] zastępuje cały argument tylko wtedy, gdy go pominięto lub przekazano undefined. Wewnętrzne = 1 i = 3 działają, gdy brakuje odpowiedniej wartości lub jest nią undefined. Wartość null wewnątrz tablicy pozostaje null. Jeśli całym argumentem jest null lub inna wartość nieiterowalna, wystąpi TypeError, zanim wykona się ciało funkcji. Bez = [] pominięty argument lub jawne undefined również powodują TypeError.

Przykłady

function describe([first = 1, , third = 3, ...rest] = []) {
  return [first, third, rest];
}

console.log(JSON.stringify(describe()));
console.log(JSON.stringify(describe([undefined, 20, null, 40, 50])));
console.log(JSON.stringify(describe(new Set([10, 20, 30]))));

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

Wynik

[1,3,[]]
[1,null,[40,50]]
[10,30,[]]
TypeError

Pierwsze wywołanie używa obu poziomów wartości domyślnych. W drugim `20` zostaje pominięte, `null` pozostaje bez zmian, a `rest` to `[40,50]`. Trzecie pokazuje, że działa też `Set`. Ostatnie wypisuje nazwę błędu, nie jego komunikat zależny od środowiska.

Powiązane lekcje

  • JavaScript · Lekcja 28 · Średniozaawansowany · Wersja: 3

Źródła