对象转原始值三步识别法

JavaScript中对象转原始值的ToPrimitive机制并非简单的“先valueOf后toString”固定流程，而是由Symbol.toPrimitive是否存在与hint类型（"string"、"number"或"default"）共同决定的动态三步策略：优先调用自定义的[Symbol.toPrimitive]方法；若无，则按hint精准选择valueOf/toString的尝试顺序（Date在"default"下更是特例，走字符串路径）；任一方法返回原始值即刻终止，否则抛出TypeError——掌握这一逻辑，你就能准确预判console.log、+obj、==比较等常见操作背后的类型转换行为，彻底告别隐式转换的困惑与陷阱。

对象转原始值（ToPrimitive）的“三步走”并不是固定按 valueOf → toString 机械执行，而是受 hint 类型 和 Symbol.toPrimitive 是否存在 共同决定的。所谓“三步”，实际是规范中对普通对象（无 Symbol.toPrimitive）在不同 hint 下的 fallback 行为，核心在于顺序可变、有优先级、且 Date 是特例。

第一步：先看有没有 Symbol.toPrimitive

只要对象定义了 [Symbol.toPrimitive](hint) 方法，无论 hint 是什么，都会优先调用它，并检查返回值是否为原始值：

• 如果返回的是原始值（如字符串、数字、布尔等），直接使用，流程结束；
• 如果返回的是对象（包括数组、函数、空对象等），或根本没定义该方法，则进入下一步——OrdinaryToPrimitive 流程。

第二步：根据 hint 决定 valueOf 和 toString 的尝试顺序

hint 是 ToPrimitive 的第二个参数，由上下文自动指定，不是开发者手动传入的。常见 hint 来源：

• "string"：来自 String(obj)、${obj}、alert(obj)、对象作属性键（obj2[obj] = 1）；
• "number"：来自 Number(obj)、一元 +、算术运算（-、*、/）、比较符（<、>）；
• "default"：主要来自 == 比较和二元加法 +（但注意：Date 对象的 "default" 实际按 "string" 处理）。

对应尝试顺序如下：

• hint = "string" → 先 toString()，再 valueOf()；
• hint = "number" → 先 valueOf()，再 toString()；
• hint = "default" → 通常等价于 "number"，即先 valueOf() 后 toString()；但 Date 是唯一例外，它的 "default" 走字符串路径（先 toString()）。

第三步：任一方法返回原始值就停止，否则报错

每一步调用后都严格检查返回值类型：

• 如果 toString() 返回字符串、数字、布尔等原始值，立即返回，不再调用 valueOf()；
• 如果 valueOf() 返回原始值（比如返回 42 或 true），也立刻返回；
• 如果两个方法都返回对象（例如都返回 {} 或 []），或其中一个返回 undefined（非原始值），则最终抛出 TypeError。

一个快速识别技巧：看操作场景反推 hint

不用死记步骤，从你写的代码出发判断 hint，就能预判走哪条路径：

• 写 console.log(obj)？→ 实际调用 String(obj) → hint 是 "string" → 先查 toString()；
• 写 +obj 或 obj * 2？→ hint 是 "number" → 先查 valueOf()；
• 写 obj == '5'？→ hint 是 "default" → 大多数对象走 valueOf() 优先，但 new Date() == '2026-05-10' 成立，因为 Date 的 "default" 等效于 "string"。

到这里，我们也就讲完了《对象转原始值三步识别法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！