Symbol.prototype[@@toPrimitive]

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

语法

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

返回值

指定的 Symbol 对象的原始值。

描述

hint 参数未使用时，Symbol 的 [@@toPrimitive]() 方法返回 Symbol 对象的原始值作为数据类型返回。

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

示例

使用 @@toPrimitive

js
const sym = Symbol("example");
sym === sym[Symbol.toPrimitive](); // true

规范

Specification
ECMAScript Language Specification
# sec-symbol.prototype-@@toprimitive

浏览器兼容性

BCD tables only load in the browser

参见