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%

瀏覽器相容性

另見