La méthodetoString() des instances deArray retourne une chaîne de caractères représentant le tableau défini et ses éléments.

Exemple interactif

const array1 = [1, 2, "a", "1a"];console.log(array1.toString());// Résultat attendu : "1,2,a,1a"

Syntaxe

toString()

Paramètres

Aucun.

Valeur de retour

Une chaîne de caractères qui représente les éléments du tableau.

Description

L'objetArray redéfinit la méthodetoString deObject. La méthodetoString des tableaux appelle en interne la méthodejoin(), qui concatène les éléments du tableau et retourne une chaîne de caractères contenant chaque élément séparé par des virgules. Si la méthodejoin n'est pas disponible ou n'est pas une fonction,Object.prototype.toString est utilisée à la place, retournant[object Array].

const arr = [];arr.join = 1; // réassigne `join` avec une valeur qui n'est pas une fonctionconsole.log(arr.toString()); // [object Array]console.log(Array.prototype.toString.call({ join: () => 1 })); // 1

JavaScript appelle automatiquement la méthodetoString lorsqu'un tableau doit être représenté sous forme de valeur texte ou lorsqu'un tableau est utilisé dans une concaténation de chaînes de caractères.

Array.prototype.toString convertit récursivement chaque élément, y compris les autres tableaux, en chaînes de caractères. Comme la chaîne retournée parArray.prototype.toString ne contient pas de délimiteurs pour les sous-tableaux, les tableaux imbriqués semblent être aplanis.

const matrix = [  [1, 2, 3],  [4, 5, 6],  [7, 8, 9],];console.log(matrix.toString()); // 1,2,3,4,5,6,7,8,9

Lorsqu'un tableau est cyclique (il contient un élément qui est lui-même), les navigateurs évitent la récursion infinie en ignorant la référence cyclique.

const arr = [];arr.push(1, [3, arr, 4], 2);console.log(arr.toString()); // 1,3,,4,2

Exemples

Utilisation detoString()

const array = [1, 2, "a", "1a"];console.log(array.toString()); // "1,2,a,1a"

Utilisation detoString() sur des tableaux creux

Comme pour le comportement dejoin(),toString() traite les cases vides commeundefined et produit un séparateur supplémentaire :

console.log([1, , 3].toString()); // '1,,3'

AppelertoString() sur des objets qui ne sont pas des tableaux

toString() estgénérique. Elle attend quethis possède une méthodejoin() ; sinon, elle utiliseObject.prototype.toString() à la place.

console.log(Array.prototype.toString.call({ join: () => 1 }));// 1 : un nombreconsole.log(Array.prototype.toString.call({ join: () => undefined }));// undefinedconsole.log(Array.prototype.toString.call({ join: "not function" }));// "[object Object]"

Spécifications

Compatibilité des navigateurs

Voir aussi

• Guide des collections indexées
• L'objet globalArray
• La méthodeArray.prototype.join()
• La méthodeArray.prototype.toLocaleString()
• La méthodeTypedArray.prototype.toString()
• La méthodeString.prototype.toString()