Array.prototype.concat()

value1, …, valueN Optional

Arrays und/oder Werte, die zu einem neuen Array verbunden werden sollen. Wenn alle valueN-Parameter weggelassen werden, gibt concat eine flache Kopie des bestehenden Arrays zurück, auf dem es aufgerufen wird. Siehe die Beschreibung unten für mehr Details.

Eine neue 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 dessen Wert in das Array integriert — für normale Objekte oder Primitive wird das Argument selbst zu einem Element des endgültigen Arrays; für Arrays oder array-ähnliche Objekte mit der Eigenschaft Symbol.isConcatSpreadable, die auf einen wahrheitsgemäßen Wert gesetzt ist, wird jedes Element des Arguments unabhängig zum endgültigen Array hinzugefügt. Die concat-Methode durchläuft nicht rekursiv verschachtelte Array-Argumente.

Die concat()-Methode ist eine Kopiermethode. Sie ändert weder this noch eines der als Argumente angegebenen Arrays, sondern gibt stattdessen eine flache Kopie zurück, die dieselben Elemente wie die der Original-Arrays enthält.

Die concat()-Methode bewahrt leere Plätze, wenn eines der Quell-Arrays spärlich ist.

Die concat()-Methode ist generisch. Der this-Wert wird in gleicher Weise behandelt wie die anderen Argumente (außer dass er zuerst in ein Objekt konvertiert wird), was bedeutet, dass einfache Objekte direkt an das resultierende Array vorangestellt werden, während array-ähnliche Objekte mit einem wahrheitsgemäßen [Symbol.isConcatSpreadable] in das resultierende Array übertragen werden.

Der folgende Code verbindet zwei Arrays:

const letters = ["a", "b", "c"];
const numbers = [1, 2, 3];

const alphaNumeric = letters.concat(numbers);
console.log(alphaNumeric);
// results in ['a', 'b', 'c', 1, 2, 3]

Der folgende Code verbindet 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);
// results in [1, 2, 3, 4, 5, 6, 7, 8, 9]

Der folgende Code fügt drei Werte zu einem Array hinzu:

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

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

console.log(alphaNumeric);
// results in ['a', 'b', 'c', 1, 2, 3]

Der folgende Code verbindet verschachtelte Arrays und zeigt die Beibehaltung von Referenzen:

const num1 = [[1]];
const num2 = [2, [3]];

const numbers = num1.concat(num2);

console.log(numbers);
// results in [[1], 2, [3]]

// modify the first element of num1
num1[0].push(4);

console.log(numbers);
// results in [[1, 4], 2, [3]]

concat behandelt nicht standardmäßig alle array-ähnlichen Objekte wie 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));
// [ 0, { '0': 1, '1': 2, '2': 3, length: 3 }, 1, 2, 3 ]

Wenn eines der Quell-Arrays 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 umgewandelt und dann in gleicher Weise 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]

• Polyfill von Array.prototype.concat in core-js mit Korrekturen und Implementierung moderner Verhaltensweisen wie Symbol.isConcatSpreadable-Unterstützung
• es-shims Polyfill von Array.prototype.concat
• Leitfaden für indizierte Sammlungen
• Array
• Array.prototype.push()
• Array.prototype.unshift()
• Array.prototype.splice()
• String.prototype.concat()
• Symbol.isConcatSpreadable