Symbol.toPrimitive 是用于定义对象转原始值逻辑的内置 Symbol，触发于需要类型转换时（如 +、==、String() 等），按 hint（"string"/"number"/"default"）调用对应方法，返回原始值否则报错。
Symbol.toPrimitive 是一个内置的 Symbol 值，用于定义对象在需要转为原始值（如字符串、数字或默认类型）时的自定义转换逻辑。它让对象能主动决定自己在不同上下文（比如 +、==、String()、Number()）中该返回什么原始值。
什么时候会触发 Symbol.toPrimitive？
当 JavaScript 引擎需要把一个对象转成原始值时，会按以下顺序尝试：
- 先检查对象是否有
[Symbol.toPrimitive](hint)方法； - 如果有，就调用它，并传入
hint（值为"string"、"number"或"default"）； - 如果没有，才退回到
toString()和valueOf()的老机制。
常见触发场景包括：obj + ""、Number(obj)、String(obj)、obj == 123、`${obj}`（模板字符串里也会触发 "default" 或 "string"，取决于环境）。
怎么写一个 Symbol.toPrimitive 方法？
给对象的属性赋一个函数，键是 Symbol.toPrimitive，函数接收一个 hint 参数，返回任意原始值（string/number/boolean/null/undefined 都行，但通常返回 string 或 number）。
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
立即学习“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（== 触发 "default"，返回 'fallback' → 再转 number？注意：这里实际走的是 ToNumber('fallback') → NaN，所以其实是 false；见下条说明）</p>⚠️ 注意：== 在比较对象和原始值时，确实会先调用 [Symbol.toPrimitive]("default")，但如果返回的不是 number 或 string，或转换后仍不相等，结果就是 false。上面例子中若返回 '42'，obj == 42 才会为 true（因为 '42' == 42 成立）。
hint 的三种取值和典型来源
-
"string"：来自String(obj)、obj + ""（明确拼接空字符串）、`${obj}`（某些引擎实现中）、obj.toString()不被调用，而是直接走 toPrimitive。 -
"number"：来自Number(obj)、+obj、obj - 1、obj * 2、obj / 3等算术运算，以及obj > 5这类关系比较（除==外）。 -
"default"：来自obj == 123、obj + 1（对象 + 数字）、obj == "abc"，还有部分引擎中模板字符串`${obj}`（规范允许实现选择 hint，默认倾向 "string"，但宽松模式下可能用 "default"）。
实用建议与注意事项
- 返回值必须是原始值，否则会报
TypeError（例如返回另一个对象）。 - 不要在
toPrimitive中修改对象状态，避免副作用——它应是纯函数。 - 如果只关心某一种转换，可以对不支持的
hint统一返回一个合理默认值，比如都返回Number(this.value)或this.label。 - 它比
toString()/valueOf()更优先，所以想完全接管转换行为，就别依赖旧方法，除非兼容老环境。
