String.prototype.concat()

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.

Exemple interactif

Syntaxe

js
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() renvoie une nouvelle chaîne correspondant à la concaténation des différents arguments avec la chaîne courante. La chaîne courante est celle sur laquelle a été appelée la méthode concat(). 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

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

js
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 que la méthode concat() pour des raisons de performance.

Spécifications

Specification
ECMAScript Language Specification
# sec-string.prototype.concat

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi