ToPrimitive转换分三步:先检查Symbol.toPrimitive方法,存在则优先调用;若无,则按hint类型决定valueOf/toString调用顺序("string"先toString,"number"/"default"先valueOf,但Date的"default"例外走toString);任一方法返回原始值即终止,否则报TypeError。

对象转原始值(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"。










