Array.prototype.toString()

La méthode toString() renvoie une chaine de caractères représentant le tableau spécifié et ses éléments.

Syntaxe

arr.toString()

Valeur de retour

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

Description

L'objet Array redéfinit la méthode toString d'Object. Pour les objets Array, la méthode toString() concatène les éléments du tableau et renvoie une chaîne contenant chacun des éléments, séparés par des virgules. Par exemple, le code qui suit crée un tableau et utilise toString() pour le convertir en une chaine de caractères.

var mois = ['Jan', 'Fév', 'Mar', 'Avr'];
var maVariable = mois.toString(); // assigne "Jan,Fév,Mar,Avr" à maVariable

JavaScript appelle la méthode toString() automatiquement lorsqu'un tableau doit être représenté par une valeur texte ou lorsqu'on fait référence à un tableau dans une concaténation de chaines de caractères.

Sémantique d'ECMAScript 5

À partir de JavaScript 1.8.5 (Firefox 4), et en cohérence avec la 5^e édition d'ECMAScript, la méthode toString() est générique et peut être utilisé avec n'importe quel objet. Si l'objet a une méthode join(), elle sera appelée et sa valeur sera renvoyée. Sinon Object.prototype.toString() sera appelé, et la valeur résultante sera renvoyée.

Spécifications

Compatibilité des navigateurs

Voir aussi

• Object.prototype.toSource()
• Array.prototype.join()