WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Destrukturierung von Objekten und iterierbaren Werten

Bei der Destrukturierung werden mithilfe eines Musters Objekteigenschaften oder aufeinanderfolgende Werte aus einem iterierbaren Objekt gelesen. Sie ermöglicht das Deklarieren von Variablen, Zuweisungen an bestehende Variablen, das Umbenennen von Bindungen, Standardwerte und das Sammeln der übrigen Werte oder Eigenschaften.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

const { key: localName = fallback, ...rest } = object;
const [first, , third = fallback, ...tail] = iterable;
({ key: existingVariable } = object);

Destrukturierung (destructuring) ist Mustersyntax, keine Funktion und kein Schlüsselwort. Ein Objektmuster wie { key } liest eine Eigenschaft anhand ihres Schlüssels, während [first] einen Wert aus einem Iterator entnimmt – die Quelle muss kein Array sein. Muster können verschachtelt und auch in Funktionsparametern verwendet werden.

Die Deklaration const { key: localName = fallback } = object erstellt localName, nicht key. Ein Standardwert wird nur ausgewertet, wenn der ausgelesene Wert undefined ist; das gilt auch bei einer fehlenden Eigenschaft. null, 0 und false lösen den Standardwert nicht aus. Die Destrukturierung von null oder undefined löst einen TypeError aus; ein Arraymuster erfordert einen iterierbaren Wert.

Ein Komma in einem Arraymuster kann eine Position überspringen. Ein abschließendes ...tail sammelt die übrigen Iteratorwerte in einem neuen Array. ...rest in einem Objektmuster kopiert die übrigen eigenen, aufzählbaren Eigenschaften in ein neues Objekt. Rest muss am Ende stehen, ohne nachfolgendes Komma. Es handelt sich nicht um eine tiefe Kopie: Verschachtelte Objekte bleiben gemeinsam genutzte Referenzen.

Eine Deklaration erstellt Bindungen, während eine Zuweisung vorhandene Ziele aktualisiert. Beginnt eine Objektzuweisung eine Anweisung, müssen Klammern verwendet werden: ({ key: existingVariable } = object);, damit { nicht als Blockanfang interpretiert wird. Im Beispiel erhält userName den Wert "Ada"; die Werte undefined lösen die Standardwerte aus.

Beispiele

const record = { name: "Ada", score: undefined, active: true };
const { name: userName, score = 10, ...rest } = record;
const [first, , third = 9, ...tail] = [2, 4, undefined, 8];
console.log(`${userName}|${score}|${rest.active}|${first}|${third}|${tail.join(",")}`);

Ergebnis

Ada|10|true|2|9|8

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen