Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Destrukturalizace polí v parametrech funkce

Vzor pole v seznamu parametrů rozbalí jeden iterovatelný argument. Výchozí hodnota celého argumentu funguje nezávisle na výchozích hodnotách jednotlivých prvků.

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

Syntaxe

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

V seznamu parametrů je [first, third] vazebný vzor pole pro jeden argument, nikoli dva samostatné parametry. Při volání vzor inicializuje lokální proměnné v pořadí iterace ještě před spuštěním těla funkce. Lze předat pole nebo jinou iterovatelnou hodnotu, například Set; obyčejný objekt s číselnými klíči a vlastností length nestačí.

Ve vzoru [first = 1, , third = 3, ...rest] prázdné místo mezi čárkami přeskočí druhou hodnotu. ...rest shromáždí zbývající hodnoty do nového pole. Jde o zbytkový prvek uvnitř vzoru, nikoli o zbytkový parametr, který sbírá samostatné argumenty volání. Musí být poslední a nesmí za ním následovat čárka.

Vnější = [] nahradí celý argument, jen pokud je vynechán nebo má hodnotu undefined. Vnitřní výchozí hodnoty = 1 a = 3 se použijí, když odpovídající hodnota chybí nebo je undefined. Hodnota null uvnitř pole zůstane null. Je-li celý argument null nebo jiná neiterovatelná hodnota, vyvolá se TypeError ještě před spuštěním těla funkce. Bez = [] vyvolá TypeError i vynechaný argument nebo předané undefined.

Příklady

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);
}

Výsledek

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

První volání využije obě úrovně výchozích hodnot. Ve druhém se `20` přeskočí, `null` zůstane zachováno a `rest` je `[40,50]`. Třetí ukazuje, že funguje i `Set`. Poslední vypíše název chyby místo hlášky závislé na prostředí.

Související lekce

  • JavaScript · Lekce 28 · Středně pokročilá · Verze: 3

Zdroje