Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
String.prototype.concat()
Baseline Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La méthodeconcat() combine le texte de plusieurs chaînes avec la chaîne appelante et renvoie la nouvelle chaîne ainsi formée.
Dans cet article
Exemple interactif
const str1 = "Hello";const str2 = "World";console.log(str1.concat(" ", str2));// Expected output: "Hello World"console.log(str2.concat(", ", str1));// Expected output: "World, Hello"Syntaxe
str.concat(string2[, string3, ..., stringN])Paramètres
string2...stringNChaî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 fonctionconcat() 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éthodeconcat(). 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éthodetoString() 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 lesopérateurs d'affectation (+, +=) plutôt que la méthodeconcat() pour des raisons de performance.
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification> # sec-string.prototype.concat> |