Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Array.prototype.concat: płytkie łączenie bez mutacji

concat tworzy nową tablicę z odbiorcy i argumentów, rozwijając tablice o jeden poziom bez zmiany źródeł.

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

Składnia

array.concat(...values)

array.concat(...values) tworzy nową tablicę. Odbiorca jest kopiowany jako pierwszy, potem argumenty: tablice i obiekty z prawdziwym Symbol.isConcatSpreadable są rozwijane o jeden poziom, pozostałe wartości stają się pojedynczymi elementami. Zagnieżdżone obiekty pozostają tymi samymi referencjami.

Metoda nie mutuje źródeł, lecz wynik może używać konstruktora gatunku tablicy. Zachowuje dziury zamiast zamieniać je na undefined. Zbyt duża wynikowa długość lub błędy getterów/proxy są przekazywane. Przykład potwierdza płytkie połączenie i niezmienioną długość wejścia.

Przykłady

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);

Wynik

A|1|B|[C]
2 true

Źródła