La méthode join()
réunit tous les éléments d'un tableau dans une chaine de caractères.
var a = ['Air', 'Eau', 'Feu']; a.join(); // 'Air,Eau,Feu' a.join('-'); // 'Air-Eau-Feu'
Syntaxe
arr.join() arr.join(séparateur)
Paramètres
séparateur
Facultatif- Ce paramètre optionnel indique une chaine de caractères pour séparer chaque élément du tableau. Le séparateur est converti en une chaine de caractères si nécessaire. Si ce paramètre n'est pas utilisé, les éléments du tableau seront séparés par une virgule. Si ce paramètre est la chaîne vide, les éléments seront accolés les uns aux autres sans espace entre. La valeur par défaut de ce paramètre est
","
.
Valeur de retour
Une chaîne de caractères composée de tous les éléments du tableau joints les uns aux autres.
Description
Les différents éléments du tableau sont convertis en une chaîne de caractères puis fusionnés en une seule chaîne. Si un élément vaut undefined
ou null
, il sera converti en la chaîne vide.
Exemples
Fusionner un tableau de quatre façons différentes
L'exemple suivant crée un tableau, a
, avec trois éléments, puis joint le tableau à trois reprises : en utilisant le séparateur par défaut, une virgule et un espace, puis un plus, puis avec la chaîne vide.
var a = new Array("Vent","Pluie","Feu"); a.join(); // "Vent,Pluie,Feu" a.join(", "); // "Vent, Pluie, Feu" a.join(" + "); // "Vent + Pluie + Feu" a.join(""); // "VentPluieFeu"
Spécifications
Spécification | État | Commentaires |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Standard | Définition initiale. Implémentée avec JavaScript 1.1. |
ECMAScript 5.1 (ECMA-262) La définition de 'Array.prototype.join' dans cette spécification. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) La définition de 'Array.prototype.join' dans cette spécification. |
Standard | |
ECMAScript 2017 Draft (ECMA-262) La définition de 'Array.prototype.join' dans cette spécification. |
Projet |
Compatibilité des navigateurs
Fonctionnalité | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Support simple | 1.0 | 1.0 (1.7 ou moins) | 5.5 | (Oui) | (Oui) |
Fonctionnalité | Android | Chrome pour Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Support simple | (Oui) | (Oui) | (Oui) | (Oui) | (Oui) | (Oui) |