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 can't use string concatenation with them:
Symbol('foo') + 'bar'; // TypeError: Can't convert symbol to string
Examples
Symbol('desc').toString(); // "Symbol(desc)" // well-known symbols Symbol.iterator.toString(); // "Symbol(Symbol.iterator) // global symbols Symbol.for('foo').toString() // "Symbol(foo)"
Specifications
Specification | Status | Comment |
---|---|---|
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'Symbol.prototype.toString' in that specification. |
Standard | Initial definition. |
ECMAScript Latest Draft (ECMA-262) The definition of 'Symbol.prototype.toString' in that specification. |
Living Standard |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | 38 | 12 | 36 | No | 25 | 9 |
Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
Basic support | Yes | 38 | Yes | 36 | No | 25 | 9 |