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

CKTIS / JavaScript

Array.prototype.join : réunir les éléments en chaîne

join convertit les éléments en texte et les sépare, les trous, null et undefined devenant des fragments vides.

Version : ECMAScript 2026 draft; example target: Node.js 24.22.2

Syntaxe

array.join([separator])

array.join([separator]) renvoie une chaîne. Le séparateur par défaut est la virgule ; un séparateur fourni est converti en texte. Chaque élément est lu et converti, sauf que null, undefined et un trou donnent un fragment vide. Un tableau imbriqué utilise son toString, donc une virgule interne apparaît généralement.

La méthode ne modifie pas le receveur et est générique pour un objet array-like. Un tableau vide donne une chaîne vide et un seul élément n’ajoute aucun séparateur. Les erreurs de getter ou conversion se propagent ; un Symbol peut lever TypeError. L’exemple montre les fragments vides et un séparateur externe indépendant.

Exemples

console.log([1, null, , 3].join("|"));
console.log([[1, 2], [3]].join(";"));
console.log(JSON.stringify([].join("-")));

Résultat

1|||3
1,2;3
""

Sources