WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Array.prototype.concat: flaches Verbinden ohne Mutation

concat erzeugt aus Empfänger und Argumenten ein neues Array und breitet Arrays eine Ebene aus, ohne Quellen zu ändern.

Version: ECMAScript 2026 draft; example target: Node.js 24.22.2

Syntax

array.concat(...values)

array.concat(...values) erzeugt ein neues Array. Zuerst wird der Empfänger kopiert, dann die Argumente: Arrays und Objekte mit wahrem Symbol.isConcatSpreadable werden eine Ebene ausgebreitet; andere Werte werden einzelne Elemente. Verschachtelte Objekte bleiben dieselben Referenzen.

Die Quellen werden nicht mutiert, das Ergebnis kann jedoch den Species-Konstruktor verwenden. Lücken bleiben Lücken statt undefined. Zu große Länge sowie Fehler aus Gettern oder Proxies werden weitergegeben. Das Beispiel bestätigt flaches Verbinden und unveränderte Eingabelänge.

Beispiele

const nested = {value: 1};
const source = ["A", nested];
const result = source.concat(["B"], [["C"]]);
console.log(result.map(value => Array.isArray(value) ? `[${value}]` : typeof value === "object" ? value.value : value).join("|"));
console.log(source.length, result[1] === nested);

Ergebnis

A|1|B|[C]
2 true

Quellen