CKTIS / JavaScript
Destrukturalizace parametrů funkce
Zapište vzor přímo do seznamu parametrů, abyste mohli číst vlastnosti objektů nebo hodnoty z iterovatelných hodnot. Rozlišujte výchozí hodnotu celého parametru od výchozích hodnot uvnitř vzoru.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
function readOptions({ label: name = "untitled" } = {}) { return name; }
function readFirst([count = 1] = []) { return count; }Při destrukturalizaci parametrů se vazebný vzor zapisuje přímo do seznamu parametrů funkce. U běžného parametru vzor pracuje s hodnotou odpovídající jedné pozici v seznamu argumentů a vytváří místní vazby dostupné v těle funkce. Vazebný vzor lze použít i u zbytkového parametru (...), ale v takovém případě se destrukturalizuje pole se zbývajícími argumenty. Argumenty se stále předávají podle pozice, nikoli podle názvu.
Objektový vzor { label } přečte vlastnost podle názvu a vytvoří místní vazbu label. Zápis { label: name } čte stejnou vlastnost, ale její hodnotu váže k místnímu názvu name. Vzor pro pole [count] převezme první hodnotu v pořadí iterace, ať už z pole, nebo z jiné iterovatelné hodnoty.
Vnější výchozí hodnoty = {} a = [] nahradí celý argument před destrukturalizací, ale pouze pokud argument nebyl předán nebo je undefined. Vnitřní výchozí hodnoty, například v name = "untitled" a count = 1, se použijí jen tehdy, je-li získaná hodnota undefined, například pokud vlastnost chybí nebo iterátor už neposkytne další hodnotu. Hodnoty null, 0, false a "" použití výchozích hodnot nevyvolají.
Předání null jako celého argumentu pro kterýkoli z těchto vzorů vyvolá chybu TypeError ještě před spuštěním těla funkce. Bez vnější výchozí hodnoty nastane stejná chyba při vynechání argumentu nebo předání undefined. Vzor pro pole vyvolá TypeError také u neiterovatelné hodnoty. Destrukturalizace nenahrazuje ověřování vstupních dat.
Příklady
function describe({ label: name = "untitled" } = {}, [count = 1] = []) {
return `${name}: ${count}`;
}
console.log(describe());
console.log(describe({ label: "draft" }, [0]));
console.log(describe({ label: null }, []));Výsledek
untitled: 1 draft: 0 null: 1
První volání použije obě úrovně výchozích hodnot. Druhé zachová `0`. Ve třetím má `label` hodnotu `null`, která se nenahrazuje, zatímco prázdné pole vede k použití `count = 1`.
Související lekce
- JavaScript · Lekce 2 · Středně pokročilá · Verze: 3