tostring在对象转字符串时被优先调用,如字符串拼接、alert、console.log、string();valueof在需原始值时被优先调用,如数学运算、比较、number();引擎按规范顺序尝试二者,重写需确保返回符合类型要求的值。

在 JavaScript 中,toString 和 valueOf 是对象的两个内置方法,它们在类型转换(尤其是隐式转换)时被自动调用。重写这两个方法,可以精确控制对象在字符串拼接、数值运算、布尔判断等场景下的表现。
toString 什么时候被调用?
当对象需要转为字符串时,JavaScript 引擎会优先尝试调用 toString():
- 字符串拼接:
"obj: " + obj -
alert(obj)、console.log(obj)(部分环境) -
String(obj)显式转换(但注意:若toString返回非字符串,且valueOf返回原始值,则可能回退) - 数组
join()、toString()方法中对元素的处理
⚠️ 注意:ECMAScript 规范规定,toString 应返回字符串。若返回非字符串,引擎不会报错,但后续行为可能不符合预期(例如字符串拼接仍会得到 [object Object] 或触发 valueOf 回退)。
valueOf 什么时候被调用?
valueOf 用于获取对象的“原始值”,在需要数值、布尔或对象上下文时被优先调用:
- 数学运算:
obj + 1、obj * 2 - 比较操作:
obj == 10(抽象相等)、obj > 5 -
Number(obj)、Boolean(obj)(但Boolean实际只依赖“真值性”,不调用valueOf或toString) - 使用
==时,若一方是原始值,另一方是对象,会先尝试valueOf,失败再试toString
✅ 规范要求 valueOf 应返回原始值(string/number/boolean/symbol/null/undefined)。返回对象会被忽略,继续尝试 toString;若两者都返回对象,则抛出 TypeError。
重写时的关键规则与顺序
当发生隐式转换时,JS 引擎按以下逻辑选取方法:
- 对于
+运算符:若任一操作数是字符串,执行字符串拼接 → 调用toString;否则尝试数值运算 → 先调用valueOf,失败再调用toString(并尝试转为 number) - 对于
==:若类型不同,尝试将对象转为原始值 → 先valueOf,再toString - 对于
String(obj):直接调用toString;若返回非字符串,再调用valueOf并转为字符串 - 对于
Number(obj):先valueOf,再toString,任一返回原始值后尝试转为 number
? 实践建议:若你希望对象在多数场景下表现为数字(如自定义金额类),重写 valueOf 返回数字;若更常用于日志或展示,重写 toString 返回易读字符串。二者可共存,但需保持语义一致,避免混淆。
典型重写示例
下面是一个表示温度的对象,支持自然的数值和字符串行为:
class Temperature {
constructor(celsius) {
this.celsius = celsius;
}
valueOf() {
return this.celsius; // 数值运算时返回摄氏度
}
toString() {
return `${this.celsius}°C`; // 字符串上下文中显示单位
}
}
<p>const t = new Temperature(25);
console.log(t + 5); // 30 (调用 valueOf)
console.log("Temp: " + t); // "Temp: 25°C" (调用 toString)
console.log(Number(t)); // 25
console.log(String(t)); // "25°C"
</p>
不复杂但容易忽略:重写这两个方法不会影响 JSON.stringify 的行为(它只序列化可枚举属性,不调用 toString/valueOf);若需定制 JSON 输出,应使用 toJSON 方法。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











