- `value1`, …, `valueN` {{optional_inline}}

- : Arrays und/oder Werte, die zu einem neuen Array verkettet werden sollen. Wenn alle

`valueN` Parameter weggelassen werden, gibt `concat` eine

{{Glossary("Shallow_copy", "flache Kopie")}} des bestehenden Arrays zurück, auf dem sie aufgerufen wird. Siehe die Beschreibung unten

für weitere Details.

Eine neue {{jsxref("Array")}} Instanz.

Die `concat`-Methode erstellt ein neues Array. Das Array wird zuerst mit den Elementen des Objekts gefüllt, auf dem es aufgerufen wird. Dann wird für jedes Argument der entsprechende Wert dem Array verkettet – für normale Objekte oder Primitive wird das Argument selbst ein Element des endgültigen Arrays; für Arrays oder array-ähnliche Objekte mit der Eigenschaft [`Symbol.isConcatSpreadable`](/de/docs/Web/JavaScript/Reference/Global_Objects/Symbol/isConcatSpreadable), die auf einen wahrheitsgemäßen Wert gesetzt ist, wird jedes Element des Arguments unabhängig dem endgültigen Array hinzugefügt. Die `concat`-Methode rekursiert nicht in verschachtelten Array-Argumenten.

Die `concat()`-Methode ist eine [kopierende Methode](/de/docs/Web/JavaScript/Reference/Global_Objects/Array#copying_methods_and_mutating_methods). Sie ändert weder `this` noch eines der übergebenen Arrays, sondern gibt eine {{Glossary("Shallow_copy", "flache Kopie")}} zurück, die die gleichen Elemente wie die der ursprünglichen Arrays enthält.

Die `concat()`-Methode bewahrt leere Stellen, wenn eines der Quellarrays [spärlich](/de/docs/Web/JavaScript/Leitfaden/Indexed_collections#spärliche_arrays) ist.

Die `concat()`-Methode ist [generisch](/de/docs/Web/JavaScript/Reference/Global_Objects/Array#generic_array_methods). Der `this`-Wert wird auf die gleiche Weise wie die anderen Argumente behandelt (außer dass er zuerst in ein Objekt konvertiert wird), was bedeutet, dass einfache Objekte direkt vor das resultierende Array gestellt werden, während array-ähnliche Objekte mit wahrheitsgemäßem `[Symbol.isConcatSpreadable]` in das resultierende Array verteilt werden.

Der folgende Code verkettet zwei Arrays:

const letters = ["a", "b", "c"];

const numbers = [1, 2, 3];

const alphaNumeric = letters.concat(numbers);

console.log(alphaNumeric);

Der folgende Code verkettet drei Arrays:

const num1 = [1, 2, 3];

const num2 = [4, 5, 6];

const num3 = [7, 8, 9];

const numbers = num1.concat(num2, num3);

console.log(numbers);

Der folgende Code verkettet drei Werte zu einem Array:

const letters = ["a", "b", "c"];

const alphaNumeric = letters.concat(1, [2, 3]);

console.log(alphaNumeric);

Der folgende Code verkettet verschachtelte Arrays und demonstriert die Beibehaltung von Referenzen:

const num1 = [[1]];

const num2 = [2, [3]];

const numbers = num1.concat(num2);

console.log(numbers);

num1[0].push(4);

console.log(numbers);

`concat` behandelt nicht standardmäßig alle array-ähnlichen Objekte als Arrays – nur wenn `Symbol.isConcatSpreadable` auf einen wahrheitsgemäßen Wert (z.B. `true`) gesetzt ist.

const obj1 = { 0: 1, 1: 2, 2: 3, length: 3 };

const obj2 = { 0: 1, 1: 2, 2: 3, length: 3, [Symbol.isConcatSpreadable]: true };

console.log([0].concat(obj1, obj2));

Wenn eines der Quellarrays spärlich ist, wird das resultierende Array ebenfalls spärlich sein:

console.log([1, , 3].concat([4, 5])); // [1, empty, 3, 4, 5]

console.log([1, 2].concat([3, , 5])); // [1, 2, 3, empty, 5]

Wenn der `this`-Wert kein Array ist, wird er in ein Objekt konvertiert und dann genauso behandelt wie die Argumente für `concat()`. In diesem Fall ist der Rückgabewert immer ein einfaches neues Array.

console.log(Array.prototype.concat.call({}, 1, 2, 3)); // [{}, 1, 2, 3]

console.log(Array.prototype.concat.call(1, 2, 3)); // [ [Number: 1], 2, 3 ]

const arrayLike = {

[Symbol.isConcatSpreadable]: true,

length: 2,

0: 1,

1: 2,

2: 99, // ignored by concat() since length is 2

};

console.log(Array.prototype.concat.call(arrayLike, 3, 4)); // [1, 2, 3, 4]

{{Specifications}}

{{Compat}}

- [Polyfill von `Array.prototype.concat` in `core-js` mit Korrekturen und Implementierung moderner Verhaltensweisen wie `Symbol.isConcatSpreadable` Unterstützung](https://github.com/zloirock/core-js#ecmascript-array)

- [es-shims polyfill von `Array.prototype.concat`](https://www.npmjs.com/package/array.prototype.concat)

- [Indexed Sammlungen](/de/docs/Web/JavaScript/Leitfaden/Indexed_collections) Leitfaden

- {{jsxref("Array")}}

- {{jsxref("Array.prototype.push()")}}

- {{jsxref("Array.prototype.unshift()")}}

- {{jsxref("Array.prototype.splice()")}}

- {{jsxref("String.prototype.concat()")}}

- {{jsxref("Symbol.isConcatSpreadable")}}