Array.prototype.concat()

La méthode concat() est utilisée afin de fusionner un ou plusieurs tableaux en les concaténant. Cette méthode ne modifie pas les tableaux existants, elle renvoie un nouveau tableau qui est le résultat de l'opération.

Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !

let nouveau_tableau = ancien_tableau.concat(valeur1[, valeur2[, ...[, valeurN]]])

valeurNFacultatif

Des tableaux et/ou des valeurs à concaténer dans le nouveau tableau. Si tous les arguments valeurN valent undefined, concat renverra une copie superficielle du tableau sur lequel elle est appelée. Voir ci-après pour plus de détails.

Une nouvelle instance de Array.

La méthode concat permet de créer un nouveau tableau constitué des éléments de l'objet this sur lequel elle a été appelée, suivis dans l'ordre par, pour chaque paramètre, les éléments de ce paramètre (s'il s'agit d'un tableau) ou le paramètre lui-même (s'il ne s'agit pas d'un tableau). La concaténation ne « déplie » pas les tableaux imbriqués.

La méthode concat ne modifie pas this ni aucun des tableaux passés en paramètres, mais renvoie une copie qui contient des copies des mêmes éléments combinées que ceux des tableaux originaux. Les éléments des tableaux originaux sont copiés dans le nouveau tableau comme suit :

• Pour les références à des objets (et non les objets eux-mêmes) : concat copie ces références dans le nouveaux tableau. Le tableau original et le nouveau tableau feront référence au même objet. C'est-à-dire que si un objet référencé est modifié, ces changements seront visibles tant dans le nouveau que dans les tableaux originaux.

• Pour les chaînes, les booléens et les nombres « primitifs » (c'est-à-dire pas les objets String, Boolean et Number) : concat copie les valeurs des chaînes et des nombres dans le nouveau tableau. (voir Les types de données en JavaScript).

Le code qui suit concatène deux tableaux :

let alpha = ["a", "b", "c"];
let numerique = [1, 2, 3];

alpha.concat(numerique);
// donne : ["a", "b", "c", 1, 2, 3]

Le code qui suit concatène trois tableaux :

let num1 = [1, 2, 3];
let num2 = [4, 5, 6];
let num3 = [7, 8, 9];

let nums = num1.concat(num2, num3);

console.log(nums);
// [1, 2, 3, 4, 5, 6, 7, 8, 9]

Le code qui suit ajoute trois valeurs à un tableau :

let alpha = ['a', 'b', 'c'];

let alphanumerique = alpha.concat(1, [2, 3]);

console.log(alphanumerique);
// ['a', 'b', 'c', 1, 2, 3]

Dans le code qui suit, on concatène deux tableaux qui ont plusieurs dimensions et on illustre la conservation des références :

let num1 = [[1]];
let num2 = [2, [3]];

let nums = num1.concat(num2);

console.log(nums);
// affichera [[1], 2, [3]]

// Ici, on modifie le premier élément de num1
num1[0].push(4);

console.log(nums);
// affichera [[1, 4], 2, [3]]

• push / pop qui permettent d'ajouter/retirer des éléments à partir de la fin du tableau
• unshift / shift qui permettent d'ajouter/retirer des éléments à partir du début du tableau
• splice qui permet d'ajouter/retirer des éléments à un endroit donné du tableau
• String.prototype.concat()
• Symbol.isConcatSpreadable (permet de contrôler la façon dont un tableau est ramené à une valeur)