Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Destrukturiranje parametrov funkcije

Z vzorci v seznamu parametrov preberete lastnosti objekta ali vrednosti iz iterabilne vrednosti. Ločite privzeto vrednost celotnega parametra od privzetih vrednosti znotraj vzorca.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

function readOptions({ label: name = "untitled" } = {}) { return name; }
function readFirst([count = 1] = []) { return count; }

Pri destrukturiranju parametrov zapišemo vezavni vzorec neposredno v seznam parametrov funkcije. Pri običajnem parametru vzorec uporabi vrednost, ki ustreza enemu položaju v seznamu argumentov, in ustvari lokalne vezave, ki so na voljo v telesu funkcije. Vezavni vzorec lahko uporabimo tudi pri parametru za preostale argumente (...), vendar takrat destrukturiramo polje, v katerem so zbrani preostali argumenti. Argumenti se še vedno podajajo po položaju, ne po imenu.

Objektni vzorec { label } prebere lastnost po imenu in ustvari lokalno vezavo label. Vzorec { label: name } prebere isto lastnost, a njeno vrednost veže na lokalno ime name. Vzorec za polje [count] vzame prvo vrednost po vrstnem redu iteracije, bodisi iz polja bodisi iz druge iterabilne vrednosti.

Zunanji privzeti vrednosti = {} in = [] nadomestita celoten argument pred destrukturiranjem, vendar le, če je izpuščen ali ima vrednost undefined. Notranje privzete vrednosti, na primer v name = "untitled" in count = 1, se uporabijo le, če je pridobljena vrednost undefined, na primer če lastnost manjka ali iterator ne poda naslednje vrednosti. Vrednosti null, 0, false in "" ne sprožijo uporabe privzetih vrednosti.

Če kateremu koli od obeh vzorcev kot celoten argument podamo null, se sproži napaka TypeError, še preden se izvede telo funkcije. Brez zunanje privzete vrednosti se enako zgodi, če argument izpustimo ali podamo undefined. Vzorec za polje sproži TypeError tudi pri neiterabilni vrednosti. Destrukturiranje ne nadomesti preverjanja vhodnih podatkov.

Primeri

function describe({ label: name = "untitled" } = {}, [count = 1] = []) {
  return `${name}: ${count}`;
}

console.log(describe());
console.log(describe({ label: "draft" }, [0]));
console.log(describe({ label: null }, []));

Rezultat

untitled: 1
draft: 0
null: 1

Prvi klic uporabi obe ravni privzetih vrednosti. Drugi ohrani `0`. Pri tretjem je vrednost lastnosti `label` enaka `null` in se ne nadomesti, prazno polje pa sproži uporabo `count = 1`.

Povezane lekcije

  • JavaScript · Lekcija 2 · Srednja · Različica: 3

Viri