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
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.
Fonctionnalité | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Support simple | Oui | Oui | 1 | Oui | Oui | Oui |
Fonctionnalité | Android webview | Chrome for Android | Edge mobile | Firefox for Android | Opera Android | iOS Safari | Samsung Internet |
---|---|---|---|---|---|---|---|
Support simple | Oui | Oui | Oui | 4 | Oui | Oui | Oui |