Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Parametr funkcji z destrukturyzacją tablicową

Rozpakuj wartości z jednego argumentu iterowalnego bezpośrednio w sygnaturze funkcji i odróżnij wartość domyślną elementu od domyślnej wartości całego parametru.

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

Składnia

function describe([first = "default", , ...rest] = []) {
  return JSON.stringify([first, rest]);
}

Tablicowy wzorzec wiązania w liście parametrów, taki jak [first, second], rozpakowuje jeden argument przed wykonaniem ciała funkcji. Nazwy first i second są dostępne w jej ciele. Wzorzec pobiera wartości w kolejności iteracji, więc argumentem może być tablica lub inna wartość iterowalna, np. Set. Zwykły obiekt z indeksami i własnością length, ale bez iteratora, powoduje TypeError.

W [first = "default", , ...rest] = [] zewnętrzne = [] zastępuje pominięty argument lub argument równy undefined pustą tablicą. Wewnętrzne = "default" działa, gdy iterator nie dostarczy pierwszej wartości lub zwróci undefined. Argument null powoduje TypeError przed wykonaniem ciała funkcji, natomiast [null] wiąże first z null.

Puste miejsce między przecinkami pomija drugą wartość. Element resztowy ...rest zbiera wszystkie pozostałe wartości do nowej tablicy; musi być ostatni we wzorcu i nie może po nim wystąpić przecinek. W odróżnieniu od parametru resztowego w function f(...args) {}, zbiera wartości z jednego argumentu, a nie pozostałe argumenty wywołania.

Przykłady

function describe([first = "default", , ...rest] = []) {
  return JSON.stringify([first, rest]);
}

console.log(describe());
console.log(describe(["A", "skip", "B", "C"]));
console.log(describe(new Set([undefined, "skip", "Z"])));
console.log(describe([null]));

Wynik

["default",[]]
["A",["B","C"]]
["default",["Z"]]
[null,[]]

Pierwsze wywołanie korzysta z obu wartości domyślnych. Drugie pomija `"skip"`; trzecie odczytuje wartości z `Set` i stosuje wewnętrzną wartość domyślną dla `undefined`. Czwarte zachowuje `null`.

Powiązane lekcje

  • JavaScript · Lekcja 7 · Zaawansowany · Wersja: 4

Źródła