String.prototype.concat()

La méthode concat() combine le texte de deux chaînes (ou plus) et renvoie une 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 et renvoie une nouvelle chaîne qui est la concaténation des différents arguments et de la chaîne courante.

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"
"".concat({}); // [object Object]

Performance

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

Spécifications

Compatibilité des navigateurs

Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une pull request sur https://github.com/mdn/browser-compat-data.

Voir aussi

• Array.prototype.concat()
• Les opérateurs d'affectation