Symbol.toPrimitive 是对象上用于自定义类型转换行为的可选方法，接收 "string"、"number" 或 "default" 提示参数，必须返回原始值；未定义时回退到 valueOf() 和 toString() 的组合逻辑。
JavaScript中对象转原始值，本质是调用对象内部的 [[ToPrimitive]] 抽象操作，它会按需尝试调用 Symbol.toPrimitive 方法；若该方法不存在或返回非原始值，则回退到 valueOf() 和 toString() 的组合逻辑。
Symbol.toPrimitive 是什么
它是对象上的一个可选方法，用于**自定义对象在类型转换时的原始值表现**。当 JavaScript 需要把对象转成字符串、数字或默认类型时（比如参与 +、==、String()、Number() 等操作），会优先查找并调用这个方法。
它接收一个参数 hint，值为 "string"、"number" 或 "default"，表示期望的转换目标类型：
-
"string"：如String(obj)、obj + ""、模板字符串中的插值 -
"number"：如Number(obj)、+obj、obj == 123（涉及数字比较） -
"default"：如obj == 123（宽松相等且无明确类型倾向）、obj + 1（+ 运算符对非字符串左操作数尝试转数字）
怎么定义 Symbol.toPrimitive 方法
直接在对象上设置该 symbol 属性，值为函数：
立即学习“Java免费学习笔记（深入）”；
const obj = {
[Symbol.toPrimitive](hint) {
if (hint === 'string') return 'hello';
if (hint === 'number') return 42;
return 'fallback';
}
};
验证效果：
-
String(obj)→"hello" -
Number(obj)→42 -
obj + ''→"hello"（hint 为"string"） -
+obj→42（hint 为"number"） -
obj == 'hello'→true（hint 为"default"，返回'fallback'，再与字符串比较）
⚠️ 注意：该方法必须返回原始值（string/number/boolean/null/undefined/symbol），否则会抛出 TypeError。
没定义 Symbol.toPrimitive 时的 fallback 行为
如果对象没有 Symbol.toPrimitive，JS 引擎会按规则尝试 valueOf() 和 toString()：
- hint 是
"string"：先调toString()，失败或返回非原始值则再调valueOf() - hint 是
"number"：先调valueOf()，失败或返回非原始值则再调toString() - hint 是
"default"：行为与"number"相同（ES6+ 规范），但 Date 对象例外——它对"default"使用toString()
例如：
const obj = {
toString() { return 'str'; },
valueOf() { return 123; }
};
obj + '' // "123"（hint "default" → 先 valueOf → 123 → 转字符串）
String(obj) // "str"（hint "string" → 先 toString）
Number(obj) // 123（hint "number" → 先 valueOf）
实际使用建议
多数情况下无需手动实现 Symbol.toPrimitive，但以下场景值得考虑：
- 封装数值类（如
Money、Duration），希望+money直接得到基础数字 - 调试友好的对象，让
console.log(obj)显示更直观的字符串（虽然 console 不强制走 toPrimitive，但'' + obj会） - 避免隐式转换歧义：显式控制不同上下文下的转换结果，比依赖
valueOf/toString更清晰
不推荐在普通业务对象中滥用此方法——容易增加理解成本，且多数场景用显式转换（如 obj.valueOf()）更安全可控。
