CKTIS / JavaScript
Array-Destrukturierung in Funktionsparametern
Ein Array-Muster in der Parameterliste entpackt ein einzelnes iterierbares Argument. Standardwerte für das gesamte Argument und für einzelne Werte sind getrennt.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
function f([first = 1, , third = 3, ...rest] = []) { /* function body */ }In der Parameterliste ist [first, third] ein Array-Bindungsmuster für ein Argument, nicht für zwei getrennte Parameter. Beim Aufruf initialisiert das Muster lokale Namen mit den Werten in Iterationsreihenfolge, bevor der Funktionsrumpf ausgeführt wird. Neben Arrays funktionieren auch andere iterierbare Werte wie ein Set; ein gewöhnliches Objekt mit numerischen Schlüsseln und einer length-Eigenschaft reicht nicht aus.
In [first = 1, , third = 3, ...rest] überspringt die leere Stelle zwischen den Kommas den zweiten Wert. ...rest sammelt die übrigen Werte in einem neuen Array. Es ist ein Rest-Element im Muster, kein Restparameter für separate Aufrufargumente. Es muss am Ende stehen und darf kein nachfolgendes Komma haben.
Das äußere = [] ersetzt das gesamte Argument nur, wenn es fehlt oder undefined ist. Die inneren Standardwerte = 1 und = 3 greifen, wenn der jeweilige Wert fehlt oder undefined ist. null innerhalb des Arrays bleibt null. Ist das gesamte Argument null oder ein anderer nicht iterierbarer Wert, tritt vor der Ausführung des Funktionsrumpfs ein TypeError auf. Ohne = [] führt auch ein weggelassenes Argument oder undefined zu einem TypeError.
Beispiele
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);
}Ergebnis
[1,3,[]] [1,null,[40,50]] [10,30,[]] TypeError
Der erste Aufruf nutzt beide Ebenen der Standardwerte. Beim zweiten wird `20` übersprungen, `null` bleibt erhalten und `rest` ist `[40,50]`. Der dritte zeigt, dass auch ein `Set` funktioniert. Der letzte gibt den Fehlernamen statt einer laufzeitabhängigen Meldung aus.
Zugehörige Lektionen
- JavaScript · Lektion 28 · Mittlere Stufe · Version: 3