The [@@toPrimitive]()
method converts a Symbol object to a primitive value.
Syntax
Symbol()[Symbol.toPrimitive](hint);
Return value
The primitive value of the specified Symbol
object.
Description
The [@@toPrimitive]()
method of Symbol
returns the primitive value of a Symbol object as a Symbol data type. The hint
argument is not used.
JavaScript calls the [@@toPrimitive]()
method to convert an object to a primitive value. You rarely need to invoke the [@@toPrimitive]()
method yourself; JavaScript automatically invokes it when encountering an object where a primitive value is expected.
Specifications
Specification | Status | Comment |
---|---|---|
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'Symbol.prototype.@@toPrimitive' in that specification. |
Standard | Initial definition. |
ECMAScript Latest Draft (ECMA-262) The definition of 'Symbol.prototype.@@toPrimitive' 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 | ? | ? | 44 | No | ? | ? |
Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
Basic support | ? | ? | ? | 44 | No | ? | ? |