Array : mthode toString()

Exemple interactif

const array1 = [1, 2, "a", "1a"];

console.log(array1.toString());
// Rsultat attendu : "1,2,a,1a"

Syntaxe

toString()

Paramtres

Aucun.

Valeur de retour

Une chane de caractres qui reprsente les lments du tableau.

Description

L'objet Array redfinit la mthode toString de Object. La mthode toString des tableaux appelle en interne la mthode join(), qui concatne les lments du tableau et retourne une chane de caractres contenant chaque lment spar par des virgules. Si la mthode join n'est pas disponible ou n'est pas une fonction, Object.prototype.toString est utilise la place, retournant [object Array].

const arr = [];
arr.join = 1; // rassigne `join` avec une valeur qui n'est pas une fonction
console.log(arr.toString()); // [object Array]

console.log(Array.prototype.toString.call({ join: () => 1 })); // 1

JavaScript appelle automatiquement la mthode toString lorsqu'un tableau doit tre reprsent sous forme de valeur texte ou lorsqu'un tableau est utilis dans une concatnation de chanes de caractres.

Array.prototype.toString convertit rcursivement chaque lment, y compris les autres tableaux, en chanes de caractres. Comme la chane retourne par Array.prototype.toString ne contient pas de dlimiteurs pour les sous-tableaux, les tableaux imbriqus 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 lment qui est lui-mme), les navigateurs vitent la rcursion infinie en ignorant la rfrence cyclique.

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

Exemples

Utilisation de toString()

const array = [1, 2, "a", "1a"];

console.log(array.toString()); // "1,2,a,1a"

Utilisation de toString() sur des tableaux creux

Comme pour le comportement de join(), toString() traite les cases vides comme undefined et produit un sparateur supplmentaire :

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

Appeler toString() sur des objets qui ne sont pas des tableaux

toString() est gnrique. Elle attend que this possde une mthode join() ; sinon, elle utilise Object.prototype.toString() la place.

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

Spcifications

Compatibilit des navigateurs

Voir aussi

• Guide des collections indexes
• L'objet global Array
• La mthode Array.prototype.join()
• La mthode Array.prototype.toLocaleString()
• La mthode TypedArray.prototype.toString()
• La mthode String.prototype.toString()