JavaScript 中怎么用 valueOf 和 toString 自定义转换-js教程-PHP中文网

javascript中，tostring优先用于字符串转换，valueof优先用于数值转换；二者须返回原始值，且避免互相调用；symbol.toprimitive会覆盖它们。

javascript 中怎么用 valueof 和 tostring 自定义转换

在 JavaScript 中，valueOf 和 toString 是两个可以被引擎自动调用的“隐式转换钩子”，用于将对象转为原始值（如数字、字符串）。它们的触发时机不同，配合使用能精准控制对象在各种上下文中的表现。

什么时候调用 toString？

当 JavaScript 需要将对象转为字符串时（比如拼接字符串、String(obj)、alert(obj)），会优先尝试调用 toString()。如果返回的是原始值（字符串、数字等），就直接使用；否则再尝试 valueOf()，最后才报错。

字符串拼接："hello " + obj → 先查 obj.toString()
String(obj) → 固定走 toString()（不查 valueOf）
注意：如果 toString() 返回的不是字符串（比如返回数字），也不会报错，但结果可能不符合预期

什么时候调用 valueOf？

当需要数值运算或显式转数字时（比如 +obj、obj * 2、Number(obj)），引擎会优先调用 valueOf()。若它返回原始值，就直接用；否则回退到 toString()，再不行就报 TypeError。

Java Development Manual

Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...

下载

算术运算：obj + 1、obj * 3 → 先查 obj.valueOf()
Number(obj) → 固定走 valueOf()（再 fallback 到 toString()）
比较操作如 obj == 42 也会触发 valueOf()（宽松相等会尝试转换）

如何安全地自定义这两个方法？

关键原则是：两个方法都必须返回原始值（string/number/boolean/null/undefined），否则可能引发意外行为或无限递归。推荐写法：

toString() 总是返回字符串（哪怕只是 "[object Custom]"）
valueOf() 总是返回有意义的数字（或布尔、字符串），且类型与业务语义一致
避免互相调用，防止栈溢出（比如 toString 里又调 valueOf，而 valueOf 又调 toString）

示例：

class Money {
  constructor(amount) {
    this.amount = amount;
  }
  toString() {
    return `$${this.amount.toFixed(2)}`;
  }
  valueOf() {
    return this.amount; // 原始 number，支持加减乘除
  }
}
const price = new Money(99.99);
console.log(price + 0.01);     // 100 → 走 valueOf()
console.log("Cost: " + price); // "Cost: $99.99" → 走 toString()
console.log(Number(price));    // 99.99 → 走 valueOf()