WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Funktionsparameter mit Array-Destrukturierung

Lies Werte aus einem einzigen iterierbaren Argument direkt in der Funktionssignatur aus und unterscheide den Standardwert eines Elements vom Standardwert des gesamten Parameters.

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

Syntax

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

Ein Array-Bindungsmuster wie [first, second] in der Parameterliste zerlegt ein einzelnes Argument, bevor der Funktionsrumpf ausgeführt wird. Die Namen first und second stehen im Rumpf zur Verfügung. Das Muster liest Werte in Iterationsreihenfolge, also kann das Argument ein Array oder ein anderes iterierbares Objekt wie ein Set sein. Ein gewöhnliches Objekt mit numerischen Indizes und length, aber ohne Iterator, führt zu einem TypeError.

In [first = "default", , ...rest] = [] setzt das äußere = [] ein leeres Array ein, wenn das Argument fehlt oder undefined ist. Das innere = "default" greift, wenn der Iterator keinen ersten Wert oder als ersten Wert undefined liefert. Das Argument null führt vor der Ausführung des Rumpfs zu einem TypeError; [null] bindet first dagegen an null.

Die Lücke zwischen den Kommas überspringt den zweiten Wert. Das Restelement ...rest sammelt alle übrigen Werte in einem neuen Array. Es muss am Ende des Musters stehen und darf kein nachgestelltes Komma haben. Anders als der Restparameter in function f(...args) {} sammelt es Werte aus einem Argument und nicht die übrigen Argumente des Aufrufs.

Beispiele

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

Ergebnis

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

Der erste Aufruf verwendet beide Standardwerte. Der zweite überspringt `"skip"`; der dritte liest aus einem `Set` und verwendet für `undefined` den inneren Standardwert. Der vierte behält `null` bei.

Zugehörige Lektionen

  • JavaScript · Lektion 7 · Fortgeschritten · Version: 4

Quellen