Array.prototype.concat()

value1, …, valueN Optional

Arrays und/oder Werte, die in ein neues Array zusammengefügt 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 weitere Details.

Eine neue Array Instanz.

Die Methode concat 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 eingefügt — bei normalen Objekten oder primitiven Werten wird das Argument selbst ein Element des endgültigen Arrays; bei Arrays oder array-ähnlichen Objekten 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 Methode concat rekursiert nicht in geschachtelte Array-Argumente.

Die Methode concat() ist eine kopierende Methode. Sie ändert weder this noch eines der bereitgestellten Arrays als Argumente, sondern gibt stattdessen eine flache Kopie zurück, die die gleichen Elemente wie die der ursprünglichen Arrays enthält.

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

Die Methode concat() ist generisch. Der Wert this wird in der gleichen Weise behandelt wie die anderen Argumente (außer dass es zuerst in ein Objekt umgewandelt wird), was bedeutet, dass einfache Objekte direkt dem resultierenden Array vorangestellt werden, während array-ähnliche Objekte mit einem wahrheitsgemäßen [Symbol.isConcatSpreadable] in das resultierende Array gestreut 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 kombiniert geschachtelte Arrays und zeigt die Beibehaltung von Verweisen:

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 alle array-ähnlichen Objekte standardmäßig 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));
// [ 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 Wert von this kein Array ist, wird er in ein Objekt konvertiert und dann in gleicher Weise wie die Argumente für concat() behandelt. 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 von modernem Verhalten wie Symbol.isConcatSpreadable Unterstützung
• es-shims Polyfill von Array.prototype.concat
• Indizierte Sammlungen Leitfaden
• Array
• Array.prototype.push()
• Array.prototype.unshift()
• Array.prototype.splice()
• String.prototype.concat()
• Symbol.isConcatSpreadable