--- title: Array.prototype.concat() slug: Web/JavaScript/Reference/Global_Objects/Array/concat translation_of: Web/JavaScript/Reference/Global_Objects/Array/concat ---
O método concat() retorna um novo array contendo todos os arrays ou valores passados como parâmetro
arr.concat(valor1, valor2, ..., valorN)
concat cria um novo array unindo todos os elementos que foram passados como parâmetro, na ordem dada, para cada argumento e seus elementos (se o elemento passado for um array).
concat não altera a si mesmo ou a qualquer um dos argumentos passados, apenas providencia um novo array contendo uma cópia de si mesmo e dos argumentos passados. Os elementos copiados são:
concat
copia os valores de strings e numbers para o novo array. Qualquer alteração no novo array não refletirá no original, e vice versa.O código a seguir une dois arrays:
var alpha = ["a", "b", "c"]; var numeric = [1, 2, 3]; // creates array ["a", "b", "c", 1, 2, 3]; alpha and numeric are unchanged var alphaNumeric = alpha.concat(numeric);
O código a seguir une três arrays:
var num1 = [1, 2, 3]; var num2 = [4, 5, 6]; var num3 = [7, 8, 9]; // creates array [1, 2, 3, 4, 5, 6, 7, 8, 9]; num1, num2, num3 are unchanged var nums = num1.concat(num2, num3);
O código a seguir une três valores ao array
var alpha = ['a', 'b', 'c']; // creates array ["a", "b", "c", 1, 2, 3], leaving alpha unchanged var alphaNumeric = alpha.concat(1, [2, 3]);
Specification | Status | Comment |
---|---|---|
ECMAScript 3rd Edition | Standard | Initial definition. Implemented in JavaScript 1.2 |
{{SpecName('ES5.1', '#sec-15.4.4.4', 'Array.prototype.concat')}} | {{Spec2('ES5.1')}} | |
{{SpecName('ES6', '#sec-array.prototype.concat', 'Array.prototype.concat')}} | {{Spec2('ES6')}} |
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | 1.0 | {{CompatGeckoDesktop("1.7")}} | 5.5 | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |