JavaScriptTableaux

Array.prototype.concat()

Combine des tableaux et des valeurs en un nouveau tableau.

Renvoie
Un nouveau tableau combiné.
Modifie l’original
Non
Sur cette page

Exemple

#
JavaScript
const frontend = ['HTML', 'CSS']
const backend = ['Node.js', 'SQL']

console.log(frontend.concat(backend, 'Git'))
console.log([...frontend, ...backend])
console.log(frontend)
Console
['HTML', 'CSS', 'Node.js', 'SQL', 'Git']
['HTML', 'CSS', 'Node.js', 'SQL']
['HTML', 'CSS']

Définition et utilisation

#

La méthode concat() crée un nouveau tableau composé des éléments du tableau courant et des arguments donnés. Les tableaux passés en argument sont décomposés en éléments (sur un niveau), et les valeurs simples sont ajoutées telles quelles.

Les tableaux d’origine ne changent pas. Dans du code moderne, le même effet s’obtient souvent avec la syntaxe de décomposition : [...a, ...b].

La combinaison est superficielle : les objets du nouveau tableau sont les mêmes que ceux des originaux.

Syntaxe

#
Syntaxe
array.concat(value1, value2, …)

Paramètres

#
  • value1…valueN

    tableaux ou valeurs

    Éléments à ajouter. Les tableaux sont décomposés sur un niveau.

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • La syntaxe [...a, ...b] est aujourd’hui plus utilisée, mais concat() reste parfois plus lisible avec plusieurs arguments.
  • Les tableaux imbriqués sur plus d’un niveau ne sont pas décomposés. Pour aplatir, utilisez flat().

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.