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.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
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.