[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/String/concat [Back]  [Original]

String.prototype.concat() - JavaScript | MDN

Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.

View in English Always switch to English

String.prototype.concat()

Baseline Large disponibilit

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 mthode concat() combine le texte de plusieurs chanes avec la chane appelante et renvoie la nouvelle chane ainsi forme.

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

js
str.concat(string2[, string3, ..., stringN])

Paramtres

string2...stringN

Chanes de caractres concatner ensemble.

Valeur de retour

Une nouvelle chane de caractres qui contient la concatnation des chanes de caractres fournies.

Description

La fonction concat() renvoie une nouvelle chane correspondant la concatnation des diffrents arguments avec la chane courante. La chane courante est celle sur laquelle a t appele la mthode concat(). Si les valeurs passes en arguments ne sont pas des chanes de caractres, elles sont automatiquement converties en chanes (grce leur mthode toString() avant la concatnation).

Exemples

L'exemple suivant combine plusieurs chanes afin d'en former une nouvelle.

js
var coucou = "Bonjour ";
console.log(coucou.concat("Tristan,", " bonne journe."));

/* Bonjour Tristan, bonne journe. */

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 oprateurs d'affectation (+, +=) plutt que la mthode concat() pour des raisons de performance.

Spcifications

Spcification
ECMAScript 2027 LanguageSpecification
# sec-string.prototype.concat

Compatibilit des navigateurs

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page