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.
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 !
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()
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.
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
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 (ECMA-262) La définition de 'String.prototype.concat' dans cette spécification. |
Standard évolutif |
Compatibilité des navigateurs
BCD tables only load in the browser
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.