对象toString与valueOf重写技巧

JavaScript 中的 `toString` 和 `valueOf` 是控制对象隐式类型转换的核心机制：前者在字符串上下文（如拼接、`console.log`、`String()`）中被优先调用，必须返回字符串以确保预期行为；后者在数值运算、比较、`Number()` 等需原始值的场景中优先触发，应返回合法原始值（否则会回退到 `toString` 或抛错）。二者协同工作，遵循严格调用顺序，合理重写可让自定义对象像原生类型一样自然参与运算与展示——比如温度对象既能参与数学计算，又能输出带单位的可读字符串，既强大又易用，是提升代码表现力与可维护性的关键技巧。

在 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`; // 字符串上下文中显示单位
  }
}
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"

不复杂但容易忽略：重写这两个方法不会影响 JSON.stringify 的行为（它只序列化可枚举属性，不调用 toString/valueOf）；若需定制 JSON 输出，应使用 toJSON 方法。

今天关于《对象toString与valueOf重写技巧》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！