String : méthode concat()

Exemple interactif

const str1 = "Bonjour";
const str2 = "Le monde";

console.log(str1.concat(" ", str2));
// Résultat attendu : "Bonjour Le monde"

console.log(str2.concat(", ", str1));
// Résultat attendu : "Le monde, Bonjour"

Syntaxe

concat(str1)
concat(str1, str2)
concat(str1, str2, /* …, */ strN)

Paramètres

str1, …, strN

Une ou plusieurs chaînes de caractères à concaténer à str. Bien que techniquement autorisé, appeler String.prototype.concat() sans arguments est une opération inutile, car elle ne résulte pas en une copie observable (comme Array.prototype.concat()), étant donné que les chaînes de caractères sont immuables. Cela ne doit se produire que si vous utilisez la syntaxe de décomposition pour passer un tableau de chaînes de caractères en tant qu'arguments, et que ce tableau est vide.

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() concatène les arguments de chaîne de caractères à la chaîne de caractères appelante et retourne une nouvelle chaîne de caractères.

Si les arguments ne sont pas de type chaîne de caractères, ils sont convertis en valeurs de type chaîne de caractères avant la concaténation.

La méthode concat() est très similaire aux opérateurs d'addition/concaténation de chaînes de caractères (+, +=), sauf que concat() force directement ses arguments à être des chaînes de caractères, tandis que l'addition force d'abord ses opérandes à être des valeurs primitives. Pour plus d'informations, voir la page de référence pour l'opérateur +.

Exemples

Utiliser la méthode concat()

L'exemple suivant combine plusieurs chaînes de caractères afin d'en former une nouvelle.

const bonjour = "Bonjour, ";
console.log(bonjour.concat("Kevin", ". Passez une bonne journée."));
// Bonjour, Kevin. Passez une bonne journée.

const listeSalutations = ["Bonjour", " ", "Kevin", "!"];
"".concat(...listeSalutations); // "Bonjour Kevin!"

"".concat({}); // "[object Object]"
"".concat([]); // ""
"".concat(null); // "null"
"".concat(true); // "true"
"".concat(4, 5); // "45"

Spécifications

Compatibilité des navigateurs

Voir aussi

• La méthode Array.prototype.concat()
• L'addition (+)