W3cubDocs

/JavaScript

symbol.toString

The toString() method returns a string representing the specified Symbol object.

Syntax

Symbol().toString()

Return value

A string representing the specified Symbol object.

Description

The Symbol object overrides the toString method of the Object object; it does not inherit Object.prototype.toString(). For Symbol objects, the toString method returns a string representation of the object.

No string concatenation

While you can call toString() on Symbols, you cannot use string concatenation with them:

Symbol('foo') + 'bar'        // TypeError: Can't convert symbol to string

Examples

Using toString

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

// well-known symbols
Symbol.iterator.toString()   // "Symbol(Symbol.iterator)

// global symbols
Symbol.for('foo').toString() // "Symbol(foo)"

Specifications

Browser compatibilityUpdate compatibility data on GitHub

Desktop
Chrome Edge Firefox Internet Explorer Opera Safari
toString 38 12 36 No 25 9
Mobile
Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
toString 38 38 36 25 9 3.0
Server
Node.js
toString 0.12

See also

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://wiki.developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol/toString