Array. prototype. join()
Assemble les éléments du tableau en une seule chaîne avec le séparateur choisi.
- Renvoie
- Une chaîne composée des éléments du tableau.
- Modifie l’original
- Non
Exemple
#const tags = ['html', 'css', 'javascript']
console.log(tags.join())
console.log(tags.join(', '))
console.log(tags.join(' · '))
console.log(['2026', '09', '28'].join('-'))Définition et utilisation
#La méthode join() convertit tous les éléments du tableau en texte et les assemble en une seule chaîne. Par défaut, elle les sépare par une virgule, mais vous pouvez indiquer n’importe quel séparateur, même une chaîne vide.
Les valeurs null et undefined sont transformées en chaînes vides, et les tableaux imbriqués en texte séparé par des virgules.
Elle fonctionne souvent en binôme avec split() : split() découpe une chaîne en tableau, join() assemble un tableau en chaîne.
Syntaxe
#array.join()
array.join(separator)Paramètres
#separator
optionnel
Texte inséré entre les éléments. Par défaut, une virgule.
Compatibilité des navigateurs
#Largement disponible
Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.
- Chrome
- Edge
- Firefox
- Safari
Bonnes pratiques
#- Pour créer des listes dans des phrases en français (« HTML, CSS et JS »),
Intl.ListFormatest préférable. - En construisant du HTML à partir d’un tableau, pensez à
join(""), sinon des virgules apparaîtront entre les éléments.
Entrées associées
#- String.prototype.split()Découpe une chaîne en un tableau de fragments selon un séparateur : un caractère, un texte ou une expression régulière.
- Array.prototype.reverse()Inverse l’ordre des éléments du tableau sur place.
- Array.prototype.map()Crée un nouveau tableau avec les résultats de l’appel d’une fonction pour chaque élément.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.