Symbol.toPrimitive 是内置 symbol，用于自定义对象在类型转换时的原始值返回逻辑；它接收 "string"、"number"、"default" 提示，必须返回原始值，否则报错，且优先级高于 valueOf 和 toString。
在 JavaScript 中，可以通过重写对象的 Symbol.toPrimitive 方法，精确控制该对象在不同类型转换场景（如转字符串、数字或默认值）下的表现。
什么是 Symbol.toPrimitive？
Symbol.toPrimitive 是一个内置 symbol，当对象参与类型转换（比如用在 +、==、String()、Number() 等上下文中）时，JavaScript 引擎会尝试调用该方法，传入一个提示（"string"、"number" 或 "default"），由你返回合适的原始值。
如何定义 Symbol.toPrimitive 方法？
只需在对象上定义一个名为 [Symbol.toPrimitive] 的方法，它接收一个参数 hint，根据提示返回字符串、数字或布尔等原始值：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
示例：
立即学习“Java免费学习笔记（深入）”；
const obj = {
value: 42,
[Symbol.toPrimitive](hint) {
if (hint === 'string') return `Obj(${this.value})`;
if (hint === 'number') return this.value * 2;
// hint === 'default' 通常按 number 处理，但也可按需返回 string
return this.value;
}
};
<p>console.log(String(obj)); // "Obj(42)"
console.log(Number(obj)); // 84
console.log(obj + ''); // "42"（+ '' 触发 default 提示 → 返回 42 → 转为 "42"）
console.log(obj == 42); // true（== 触发 default 提示 → 返回 42）
hint 的三种取值及典型触发场景
-
"string"：被
String()、obj.toString()（显式）、模板字符串`${obj}`、JSON.stringify（不走这里，走toJSON）等调用 -
"number"：被
Number()、parseInt()、算术运算（+obj、obj - 1）、比较运算（obj > 10）等调用 -
"default"：被宽松相等（
==）、+拼接（obj + 1）、console.log(obj)（部分环境）等调用；若未显式处理，建议 fallback 到"number"或"string"之一
注意事项与常见陷阱
- 返回值必须是原始类型（string / number / boolean / null / undefined / symbol），否则会报
TypeError - 如果没定义
Symbol.toPrimitive，引擎会依次尝试valueOf()和toString()（老式机制），但有了Symbol.toPrimitive后，这两个方法会被跳过 - 箭头函数不能用作
[Symbol.toPrimitive]，因为它没有this绑定；必须用普通函数或方法简写 - 在类中定义时，推荐写在原型上（如
MyClass.prototype[Symbol.toPrimitive] = function(hint) { ... }），便于实例复用
