Symbol.prototype.toString()

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2015.

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

Dans cet article

Exemple interactif

console.log(Symbol("desc").toString());
// Expected output: "Symbol(desc)"

console.log(Symbol.iterator.toString());
// Expected output: "Symbol(Symbol.iterator)

console.log(Symbol.for("foo").toString());
// Expected output: "Symbol(foo)"

// console.log(Symbol('foo') + 'bar');
// Expected output: Error: Can't convert symbol to string

Syntaxe

Symbol().toString();

Valeur de retour

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

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 :

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

Exemples

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

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

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