Symbol.prototype[Symbol.toPrimitive]()

Baseline 已广泛支持

该特性已非常成熟,可在多种设备和浏览器版本上使用。自 2017 年 4 月以来,它已在各大浏览器上可用。

[Symbol.toPrimitive]() 方法是一个 Symbol 值,用于返回该 Symbol 值。

语法

js
symbolValue[Symbol.toPrimitive](hint)

参数

hint

一个字符串,指示要返回的原始值。该值被忽略。

返回值

指定的 Symbol 对象的原始值。

描述

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

JavaScript 调用 [Symbol.toPrimitive]() 方法将对象转换为原始值。你很少需要自己调用 [Symbol.toPrimitive]() 方法;当 JavaScript 遇到需要原始值的对象时,它会自动调用此方法。

示例

使用 [Symbol.toPrimitive]()

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

规范

规范
ECMAScript® 2026 语言规范
# sec-symbol.prototype-%symbol.toprimitive%

浏览器兼容性

另见