Array.prototype.concat()

value1, …, valueN Optional

Arrays und/oder Werte, die zu einem neuen Array verkettet werden sollen. Wenn alle valueN Parameter weggelassen werden, gibt concat eine flache Kopie des bestehenden Arrays zurück, auf dem sie aufgerufen wird. Siehe die Beschreibung unten für weitere 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 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, 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. Sie ändert weder this noch eines der übergebenen Arrays, sondern gibt eine 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 ist.

Die concat()-Methode ist generisch. 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);
// results in ['a', 'b', 'c', 1, 2, 3]

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

Der folgende Code verkettet drei Werte zu einem Array:

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 verkettet verschachtelte Arrays und demonstriert 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 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 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]

• 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
• Indexed Sammlungen Leitfaden
• Array
• Array.prototype.push()
• Array.prototype.unshift()
• Array.prototype.splice()
• String.prototype.concat()
• Symbol.isConcatSpreadable