Symbol.toPrimitive 是 JavaScript 中用于自定义对象类型转换行为的内置 symbol，其值为接收 hint（"string"、"number" 或 "default"）参数的函数，优先于 toString 和 valueOf 被引擎调用以返回对应原始值。
Symbol.toPrimitive 是 JavaScript 中一个特殊的内置 symbol，用于自定义对象在类型转换（如转字符串、数字或默认值）时的行为。它让开发者能精确控制对象参与 +、==、String()、Number() 等操作时的转换逻辑。
Symbol.toPrimitive 是什么
它是对象上的一个方法属性，键为 Symbol.toPrimitive，值是一个函数。该函数接收一个字符串参数 hint，表示期望的转换目标类型，取值为："string"、"number" 或 "default"。JS 引擎在需要将对象转为原始值时，会自动调用此方法（如果存在），并根据 hint 决定返回哪个原始值。
如何定义和使用
在对象上设置 [Symbol.toPrimitive] 方法即可生效：
例：
立即学习“Java免费学习笔记（深入）”；
const obj = {
[Symbol.toPrimitive](hint) {
if (hint === 'string') return 'hello';
if (hint === 'number') return 42;
return 'fallback'; // hint === 'default'
}
};
<p>console.log(String(obj)); // "hello"
console.log(Number(obj)); // 42
console.log(obj + ''); // "fallback"（+ 操作符 hint 为 'default'）
console.log(obj == 42); // true（== 触发 hint: 'number'）
hint 的实际触发场景
-
"string"：出现在String(obj)、obj.toString()（仅当toString和valueOf都未返回原始值时才退到 toPrimitive）、obj + ''（某些引擎优化下可能跳过，但规范要求先尝试default） -
"number"：出现在Number(obj)、+obj、obj - 1、obj == 100、obj > 5等数值上下文 -
"default"：出现在obj + ''（明确要求原始值但无强类型倾向）、obj == 'x'（宽松相等且两边类型不一致）、console.log(obj)（部分环境）
与 toString/valueOf 的关系
若对象没有定义 [Symbol.toPrimitive]，JS 会回退到传统方式：先调用 valueOf()，若返回原始值则使用；否则再调用 toString()。一旦定义了 Symbol.toPrimitive，它就完全取代 valueOf 和 toString 在类型转换中的作用——即使后两者存在，也不会被自动调用。
注意：toString() 和 valueOf() 仍可被显式调用，只是不再参与隐式转换流程。
