Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

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 5e é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

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.toString' dans cette spécification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'Array.prototype.toString' dans cette spécification.
Standard  
ECMAScript 2017 Draft (ECMA-262)
La définition de 'Array.prototype.toString' dans cette spécification.
Projet  

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support simple (Oui) (Oui) (Oui) (Oui) (Oui)
Fonctionnalité Android Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple (Oui) (Oui) (Oui) (Oui) (Oui) (Oui)

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight, teoli, tregagnon, Jeremie, BenoitL
 Dernière mise à jour par : SphinxKnight,