WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Destrukturierung von Funktionsparametern

Mit Mustern direkt in der Parameterliste liest du Objekteigenschaften oder Werte aus einem iterierbaren Wert. Unterscheide Standardwerte für ganze Parameter von Standardwerten innerhalb eines Musters.

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

Syntax

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

Bei der Destrukturierung von Parametern steht ein Bindungsmuster direkt in der Parameterliste der Funktion. Bei einem gewöhnlichen Parameter verwendet das Muster den Wert für eine einzelne Argumentposition und erzeugt lokale Bindungen, die im Funktionsrumpf verfügbar sind. Auch ein Restparameter (...) kann ein Bindungsmuster verwenden. In diesem Fall wird das Array mit den verbleibenden Argumenten destrukturiert. Die Argumente werden weiterhin nach Position und nicht nach Namen übergeben.

Das Objektmuster { label } liest eine Eigenschaft anhand ihres Namens und erzeugt eine lokale Bindung namens label. { label: name } liest dieselbe Eigenschaft, bindet ihren Wert aber an den lokalen Namen name. Das Arraymuster [count] übernimmt den ersten Wert in Iterationsreihenfolge, aus einem Array oder einem anderen iterierbaren Wert.

Äußere Standardwerte = {} und = [] ersetzen das ganze Argument vor der Destrukturierung, aber nur, wenn es fehlt oder undefined ist. Innere Standardwerte wie name = "untitled" und count = 1 greifen nur, wenn der entnommene Wert undefined ist, etwa wenn eine Eigenschaft fehlt oder der Iterator keinen weiteren Wert liefert. null, 0, false und "" lösen keine Standardwerte aus.

Wird null als ganzes Argument an eines der beiden Muster übergeben, wird ein TypeError ausgelöst, bevor der Funktionsrumpf ausgeführt wird. Ohne äußeren Standardwert passiert dasselbe bei einem fehlenden Argument oder bei undefined. Ein Arraymuster löst auch bei einem nicht iterierbaren Wert einen TypeError aus. Destrukturierung ersetzt keine Eingabevalidierung.

Beispiele

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

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

Ergebnis

untitled: 1
draft: 0
null: 1

Der erste Aufruf nutzt beide Ebenen von Standardwerten. Der zweite behält `0` bei. Beim dritten wird `null` für `label` nicht ersetzt, während das leere Array dazu führt, dass `count = 1` greift.

Zugehörige Lektionen

  • JavaScript · Lektion 2 · Mittlere Stufe · Version: 3

Quellen