Symbol.prototype[@@toPrimitive]

[@@toPrimitive]() 方法可将 Symbol 对象转换为原始值。

语法

Symbol()[Symbol.toPrimitive](hint);

返回值

该原始值为指定的 Symbol 对象

描述

 Symbol 的 [@@toPrimitive]() 方法返回该 Symbol 对象原始值作为 Symbol 数据形式。 hint 参数未被使用。

JavaScript 调用 [@@toPrimitive]() 方法将一个对象转换为原始值表示。你不需要自己调用 [@@toPrimitive]() 方法；当对象需要被转换为原始值时，JavaScript 会自动地调用该方法。

规范

Specification Status Comment
ECMAScript 2015 (6th Edition, ECMA-262)
Symbol.prototype.@@toPrimitive		 Standard Initial definition.
ECMAScript Latest Draft (ECMA-262)
Symbol.prototype.@@toPrimitive		 Draft

浏览器兼容性

Update compatibility data on GitHub
Desktop Mobile Server
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet Node.js
@@toPrimitive Chrome Full support 47 Edge Full support 15 Firefox Full support 44 IE No support No Opera Full support 34 Safari ? WebView Android Full support 47 Chrome Android Full support 47 Firefox Android Full support 44 Opera Android Full support 34 Safari iOS ? Samsung Internet Android Full support 5.0 nodejs ?

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown

参考资料

  1. JavaScript 标准库
  2. Symbol
  3. 属性
    1. Symbol.asyncIterator
    2. Symbol.hasInstance
    3. Symbol.isConcatSpreadable
    4. Symbol.iterator
    5. Symbol.match
    6. Symbol.matchAll
    7. Symbol.prototype
    8. Symbol.prototype.description
    9. Symbol.replace
    10. Symbol.search
    11. Symbol.species
    12. Symbol.split
    13. Symbol.toPrimitive
    14. Symbol.toStringTag
    15. Symbol.unscopables
  4. 方法
    1. Symbol.for()
    2. Symbol.keyFor()
    3. Symbol.prototype.toSource()
    4. Symbol.prototype.toString()
    5. Symbol.prototype.valueOf()
    6. Symbol.prototype[@@toPrimitive]
  5. 继承
  6. Function
  7. 属性
    1. Function.arguments
    2. Function.arity
    3. Function.caller
    4. Function.displayName
    5. Function.length
    6. Function.name
    7. Function.prototype
  8. 方法
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.isGenerator()
    5. Function.prototype.toSource()
    6. Function.prototype.toString()
  9. Object
  10. 属性
    1. Object.prototype.__count__
    2. Object.prototype.__noSuchMethod__
    3. Object.prototype.__parent__
    4. Object.prototype.__proto__
    5. Object.prototype.constructor
  11. 方法
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.unwatch()
    12. Object.prototype.valueOf()
    13. Object.prototype.watch()
    14. Object.setPrototypeOf()