JavaScript 对象转原始值：同一个对象，拼接和乘法为什么走不同提示
一个封装数量的对象放进模板字符串时显示为“十二件”，乘以二却能算出二十四。随后有人用空字符串加对象来生成日志，又得到另一种文字。这里并非随机调用了某个方法，而是不同操作给对象转换提供了不同提示。
Symbol.toPrimitive 允许对象参与这一步。它收到 string、number 或 default 提示，并返回一个原始值。提示说明调用方的转换偏好，并不强制返回值必须同名类型。最终结果还要由外层运算符接着处理。
让每次转换自己留下记录
保存为 demo.mjs，以 node demo.mjs 运行。本文在 Node.js v24.19.0 验证。示例刻意让三种提示返回不同内容，并把收到的提示追加到数组。这样即使最终文字看起来相似，也能验证中间选择了哪条路径。
AI概念示意图：表现本文的抽象关系，并非软件截图或真实运行结果。
import assert from 'node:assert/strict';
const hints = [];
const amount = {
[Symbol.toPrimitive](hint) {
hints.push(hint);
if (hint === 'number') return 12;
if (hint === 'string') return '12 units';
return 'amount';
}
};
assert.equal(String(amount), '12 units');
assert.equal(`${amount}`, '12 units');
assert.equal(amount * 2, 24);
assert.equal(amount + 1, 'amount1');
assert.equal('' + amount, 'amount');
assert.deepEqual(hints, ['string', 'string', 'number', 'default', 'default']);
const before = hints.length;
assert.equal(Boolean(amount), true);
assert.equal(amount === 12, false);
assert.equal(hints.length, before);
const invalid = { [Symbol.toPrimitive]() { return {}; } };
assert.throws(() => String(invalid), TypeError);
console.log(hints.join(','));
console.log('primitive-conversion checks passed');加号拿到 default，再决定是否拼接
前两次显式字符串展示都收到 string，因此输出 12 units。乘法需要数值，收到 number 后返回十二，再与二相乘。加一却收到 default，示例返回的是 amount 字符串，于是外层加法执行拼接，得到 amount1。
空字符串加对象同样使用 default，所以它不是 String 对象转换的通用替代写法。看似都是“变成文字”，实际请求可能不同。排查日志差异时，应把具体表达式留下，不能只记录业务上的“转字符串”描述。
提示本身也不是类型校验器。你可以在 number 提示下返回数字形状的字符串，后续运算再处理它；但这种设计会让转换路径更难理解。对自定义数据类型，最好让每条分支的返回类型和用途清楚、稳定，并写出代表性断言。
对象不能在这一步再交回另一个对象
invalid 的转换函数返回空对象，String 调用立即抛出 TypeError。此处不能通过不断包装对象来推迟决定，也不能期待引擎自动从新对象里继续寻找数值。方法的契约是交出原始值，失败应当被调用方明确看到。
另一方面，Boolean(amount) 为真，却没有增加 hints 的长度。对象的布尔判断不通过这套钩子。严格相等比较也没有触发它，对象与数字十二仍不相等。因此不要把一个转换方法理解为接管所有运算的全局入口。
这种钩子适合少量有明确展示和数值语义的对象，但隐式调用可能发生在不显眼的位置。若钩子修改外部状态、访问网络或依赖当前时间，普通拼接都会变成复杂操作。本文的数组记录只用于实验，业务实现应尽量保持简单。
如果数据来自不熟悉的对象，实现日志或格式化时也不应假定转换永远成功。测试可以包含抛错钩子，并确认异常由哪一层负责处理。打印调试文字不是绝对没有副作用的动作，尤其当对象可由外部插件提供时。
涉及金额、单位或精度的业务值，通常更适合提供明确的读取与格式化方法，让调用者主动选择。若确实使用原始值转换，应把模板、乘法、加法、布尔值和严格比较一起测试，确保团队看到的是一套可解释的接口。
