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