Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Array.prototype.concat: concatenação superficial sem mutação

concat cria um array novo a partir do recetor e argumentos, expandindo arrays um nível sem alterar as fontes.

Versão: ECMAScript 2026 draft; example target: Node.js 24.22.2

Sintaxe

array.concat(...values)

array.concat(...values) cria um array novo. Copia primeiro o recetor e depois os argumentos: arrays e objetos com Symbol.isConcatSpreadable verdadeiro são expandidos um nível; os restantes valores tornam-se um elemento. Objetos aninhados mantêm a mesma referência.

Não altera as fontes, embora o resultado possa usar o construtor species. Preserva posições vazias. Comprimento excessivo e erros de getters ou proxies propagam-se. O exemplo confirma concatenação superficial e comprimento da entrada inalterado.

Exemplos

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

Resultado

A|1|B|[C]
2 true

Fontes