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.