JavaScript中将自定义类实例转为原始值，首选实现Symbol.toPrimitive方法，其次可实现valueOf()和toString()；前者优先级最高且可控，后者需注意上下文调用顺序及返回类型规范。
JavaScript 中把自定义类的实例对象转为原始值，核心是实现 Symbol.toPrimitive 方法，或者退而求其次实现 toString() 和 valueOf()。引擎在需要原始值（比如参与加法、字符串拼接、显式转换）时，会按特定顺序调用这些方法。
优先级最高的方式：定义 Symbol.toPrimitive
这是最明确、最可控的方式。当对象参与类型转换（如 + obj、String(obj)、Number(obj)）时，JS 引擎会首先查找并调用该方法，并传入提示（"default"、"string" 或 "number"）。
示例：
class Money {
constructor(amount) {
this.amount = amount;
}
[Symbol.toPrimitive](hint) {
switch (hint) {
case 'string':
return `$${this.amount.toFixed(2)}`;
case 'number':
return this.amount;
case 'default':
default:
return this.amount; // 或返回字符串，取决于你的语义
}
}
}
const m = new Money(123.45);
console.log(m + 10); // 133.45 → 调用 hint='number'
console.log(`${m}`); // "$123.45" → 调用 hint='string'
console.log(Number(m)); // 123.45
console.log(String(m)); // "$123.45"
兼容老环境的备选：实现 valueOf() 和 toString()
如果没定义 Symbol.toPrimitive，JS 会按规则回退：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
- 数值上下文（如
+ obj、Math.max(obj, 5)）→ 先调valueOf()，失败再调toString()； - 字符串上下文（如
'' + obj、alert(obj)）→ 先调toString()，失败再调valueOf()； -
==比较时行为较复杂，也依赖这两个方法。
注意：valueOf() 应尽量返回“本质数值”，toString() 返回“可读字符串”，避免两者都返回相同类型（比如都返回字符串），否则可能引发意外行为（如 obj == '123' 可能误判）。
示例：
class Counter {
constructor(val) {
this.value = val;
}
valueOf() {
return this.value;
}
toString() {
return `Counter(${this.value})`;
}
}
const c = new Counter(42);
console.log(c + 1); // 43
console.log('' + c); // "Counter(42)"
console.log(c == 42); // true（因为 valueOf 返回 42）
常见陷阱与建议
- 不要在
Symbol.toPrimitive中返回另一个对象 —— 必须返回原始值（string/number/boolean/null/undefined/symbol），否则会抛TypeError； - 避免让
valueOf()和toString()都返回字符串，否则在数值运算中可能静默失败（例如obj + 1变成字符串拼接）； - 若类语义上“本质就是一个数字”（如
Seconds、Percent），推荐只实现Symbol.toPrimitive并对"number"和"default"返回数值； - 调试时可用
console.log(typeof obj[Symbol.toPrimitive]('number'))快速验证返回类型是否正确。
不推荐的方式：靠隐式转换碰运气
不实现任何方法，完全依赖 JS 默认行为（即返回 [object Object]）—— 这几乎总是错误的起点。比如 new Money(5) + 3 会变成 "[object Object]3"，而不是 8。这种行为不可控，也不符合封装意图。
