Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

String.prototype.concat — joindre des chaînes

String.prototype.concat ajoute un nombre quelconque d’arguments à une chaîne en les convertissant en texte. La méthode renvoie une valeur primitive de type string et ne modifie pas la chaîne d’origine.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

str.concat(...args)

String.prototype.concat joint la chaîne du récepteur à zéro ou plusieurs arguments, dans l’ordre fourni. La méthode n’insère aucun séparateur : les espaces et la ponctuation doivent être fournis explicitement. Le résultat est une valeur primitive de type string, et non un objet String.

Les chaînes sont immuables : la méthode ne modifie pas la valeur d’origine. Affectez le résultat à une variable pour le conserver. Un appel sans argument renvoie le texte du récepteur sans le modifier.

Le récepteur est d’abord converti en texte, puis les arguments le sont de gauche à droite, au moyen de ToString. Les arguments null et undefined produisent respectivement "null" et "undefined" ; un argument de type symbol déclenche une TypeError. La conversion d’objets peut exécuter du code personnalisé et déclencher une exception.

La méthode est générique : String.prototype.concat.call(42, "!") renvoie "42!". En revanche, null et undefined comme récepteur provoquent une TypeError. Il s’agit d’une méthode standard d’ECMAScript, et non d’une API de navigateur.

Exemples

const base = "Level";
const result = base.concat(" ", 3, "!");
console.log(result);
console.log(base);
console.log(base.concat() === base);

Résultat

Level 3!
Level
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources