La méthode concat() combine le texte de plusieurs chaînes avec la chaîne appelante et renvoie la nouvelle chaîne ainsi formée.

Syntaxe

str.concat(string2[, string3, ..., stringN])

Paramètres

string2...stringN
Chaînes de caractères à concaténer ensemble.

Valeur de retour

Une nouvelle chaîne de caractères qui contient la concaténation des chaînes de caractères fournies.

Description

La fonction concat() combine le texte de plusieurs chaînes avec et renvoie une nouvelle chaîne qui est la concaténation des différents arguments et de la chaîne courante. Si les valeurs passées en arguments ne sont pas des chaînes de caractères, elles sont automatiquement converties en chaînes (grâce à leur méthode toString() avant la concaténation).

Exemples

Utiliser concat()

L'exemple suivant combine plusieurs chaînes afin d'en former une nouvelle.

var coucou = "Bonjour ";
console.log(coucou.concat("Tristan,", " bonne journée.")); 

/* Bonjour Tristan, bonne journée. */

var salutation = ['Bonjour', ' ', 'Alfred', ' ', '!'];
"".concat(...salutation); // "Bonjour Alfred !"

"".concat({});   // [object Object]
"".concat([]);   // ""
"".concat(null); // "null"
"".concat(true); // "true"
"".concat(4, 5); // "45"

Performance

Il est fortement recommandé d'utiliser les opérateurs d'affectation (+, +=) plutôt la méthode concat() que  pour des raisons de performance. Voir ce test de perfomance.

Spécifications

Spécification État Commentaires
ECMAScript 3rd Edition (ECMA-262) Standard Définition initiale. Implémentée avec JavaScript 1.2.
ECMAScript 5.1 (ECMA-262)
La définition de 'String.prototype.concat' dans cette spécification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'String.prototype.concat' dans cette spécification.
Standard  
ECMAScript Latest Draft (ECMA-262)
La définition de 'String.prototype.concat' dans cette spécification.
Projet  

Compatibilité des navigateurs

FonctionnalitéChromeEdgeFirefoxInternet ExplorerOperaSafari
Support simple Oui Oui1 Oui Oui Oui
FonctionnalitéAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Support simple Oui Oui Oui4 Oui Oui Oui

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight, JNa0, tregagnon, miam
 Dernière mise à jour par : SphinxKnight,