String.prototype.concat()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

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

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® 2025 Language Specification
# sec-string.prototype.concat

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
concat

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Voir aussi