symbol.toprimitive是javascript中优先级高于tostring和valueof的类型转换开关，用于自定义对象转字符串、数字或默认类型时的原始值返回；需作为自有属性实现，接收hint参数（"string"/"number"/"default"），必须返回原始值，否则抛typeerror。
Symbol.toPrimitive 是 JavaScript 中一个鲜为人知但极其精准的“类型转换开关”——它允许你完全自定义对象在被转为字符串、数字或默认类型时返回什么原始值，且优先级高于 toString() 和 valueOf()。
它在哪起作用？
只要对象参与以下任一强制类型转换，引擎就会查找并调用该方法：
- 字符串拼接：
obj + '' - 算术运算：
+obj、obj - 1、obj * 2 - 比较操作：
obj == 42（非严格相等）、obj > 10 - 显式转换：
String(obj)、Number(obj)、Boolean(obj)（注意：Boolean不触发toPrimitive，除非内部转为数字/字符串再判断）
如何正确实现 Symbol.toPrimitive
该方法必须是对象自身的自有属性（不能靠原型链继承），接收一个参数 hint，表示期望的类型，取值为 "string"、"number" 或 "default"。你需要返回一个原始值（string / number / boolean / null / undefined / symbol），否则会抛出 TypeError。
示例：
const obj = {
[Symbol.toPrimitive](hint) {
if (hint === 'string') return 'hello';
if (hint === 'number') return 42;
return 'fallback'; // hint === 'default' 时的兜底
}
};
<p>console.log(obj + ''); // "hello" ← 字符串上下文 → hint='string'
console.log(+obj); // 42 ← 数字上下文 → hint='number'
console.log(obj == 'hello'); // true ← == 触发 hint='default'，返回 'fallback'，再与 'hello' 比较？等等 —— 实际上这里会先尝试 hint='number'，失败后才试 'string'；但更准确地说：== 对象比较时，引擎会先按 hint='default' 调用，若返回非原始值，再依次尝试 'number' 和 'string'。所以稳妥做法是：hint='default' 时明确返回你希望的默认原始值（常与 'number' 或 'string' 一致）</p>
常见陷阱与建议
-
不要返回对象：哪怕返回
new Number(42)或{ toString() { return 'x' } }都会报错 —— 必须是原始值。 -
hint 是提示，不是指令：引擎可能忽略你的 hint。比如
obj == 5在某些场景下仍可能以'number'调用，即使你返回了字符串。因此逻辑应尽量保持一致：例如让'default'行为与'number'相同，避免歧义。 -
慎用于可变状态对象：如果对象内部状态变化（如计数器），而
toPrimitive返回依赖状态的值，可能造成隐式行为难以追踪（比如obj + ''每次结果不同）。 -
优先级高于 toString/valueOf：一旦定义了
Symbol.toPrimitive，这两个老方法就彻底失效，无需再维护它们。
实用场景举例
适合需要语义清晰、类型安全的封装场景：
-
金额类：
Money(19.99, 'USD')在Number(money)时返回数值，在String(money)时返回"$19.99"，在模板中自动渲染友好格式。 -
ID 封装类：如
UserId('abc123')，Number(id)报错（ID 不是数字），String(id)返回原始 ID 字符串，id + ''安全输出。 -
调试友好的占位对象：开发时返回
`[Object:${this.constructor.name}]`，生产环境返回空字符串或 0，避免意外污染计算。
