Symbol.prototype.toString()

La méthode toString() renvoie une chaîne de caractères représentant l'objet Symbol.

Syntaxe

Symbol().toString();

Valeur de retour

Une chaîne de caractères qui représente l'objet Symbol.

Description

L'objet Symbol surcharge la méthode toString() d'Object et n'hérite pas de Object.prototype.toString(). Pour les objets Symbol, la méthode toString() renvoie représentation de l'objet sous forme d'une chaîne de caractères.

Concaténation de chaînes et symboles

Bien qu'il soit possible d'appeler toString() pour les symboles, il n'est pas possible de concaténer une chaîne de caractères avec ce type d'objet :

Symbol("toto") + "machin";  // TypeError : Impossible de convertir un symbole en chaîne de caractères

Exemples

Symbol("desc").toString();   // "Symbol(desc)"

// symboles connus
Symbol.iterator.toString();  // "Symbol(Symbol.iterator)

// symboles globaux
Symbol.for("toto").toString() // "Symbol(toto)"

Spécifications

Spécification État Commentaires
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'Symbol.prototype.toString' dans cette spécification.
Standard Définition initiale
ECMAScript (ECMA-262)
La définition de 'Symbol.prototype.toString' dans cette spécification.
Standard évolutif  

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi