JSON.rawJSON 怎么在序列化时保留超大整数文本

如果后端返回的订单号或金额最小单位超过 JavaScript 的安全整数范围，先不要把它直接转成普通 Number。数字在进入 JSON.stringify 之前就可能已经被舍入，最后输出的文本自然无法恢复。浏览器已经支持 JSON.rawJSON 的运行时，可以把经过校验的数字片段作为原始 JSON 原子值交给序列化器。

一、先看普通 Number 为什么会改写超大整数

JavaScript 的 Number 使用双精度浮点表示，不能把所有整数逐个精确保存。比如下面的字面量看起来是一个完整的 20 位整数，但它在赋给变量的瞬间就可能变成另一个可表示的值：

const value = 12345678901234567890;
// 这里的字面量已经先经过 Number 表示，不能再找回原始数字文本
console.log(JSON.stringify({ value }));
// 结果可能是 {"value":12345678901234567000}

如果服务端把这个 ID 当作 JSON 数字发来，前端更稳妥的做法是先保留原始文本，或者让服务端把它作为字符串传输。只有在你确实需要输出 JSON 数字、且消费端也能处理它时，才使用 raw JSON。

二、用 JSON.rawJSON 把已校验的数字文本交给序列化器

JSON.rawJSON(string) 不把参数当作普通字符串值，而是把它视为一段需要符合 JSON 语法的原子片段。数字文本因此不会先走一次 Number 舍入：

const orderIdText = "12345678901234567890";
// 只允许来自可信协议或白名单校验后的数字文本进入 rawJSON
const orderId = JSON.rawJSON(orderIdText);
const payload = JSON.stringify({ orderId });
// 输出中的 orderId 是数字文本，不会被自动加引号或转成近似值
console.log(payload);

这里的核心不是“把字符串变成更大的 Number”，而是告诉序列化器：这段内容已经是 JSON 文本。接收方若再次解析为普通 Number，仍然可能丢精度；跨服务传输时必须和后端、SDK 约定数字 ID 的消费类型。

三、rawJSON 的参数边界要先校验

输入必须代表合法的 JSON 原子值。数字、布尔值和 null 可以直接传入；如果想输出 JSON 字符串，参数本身必须包含双引号。对象和数组不能通过这个 API 注入。

function rawInteger(text) {
  // 先限制为十进制整数，避免把未经审查的 JSON 片段直接拼进响应
  if (!/^-?(0|[1-9]\d*)$/.test(text)) {
    throw new TypeError("整数文本格式不合法");
  }
  // JSON.rawJSON 自己还会检查 JSON 语法，这里只负责业务边界
  return JSON.rawJSON(text);
}

const body = JSON.stringify({ id: rawInteger("12345678901234567890") });
// body 中的 id 保持为 JSON 数字，而不是带引号的字符串
console.log(body);

四、上线前把运行时和消费端一起纳入清单

这项能力适合已经确认运行时支持它的前端或 Node.js 服务。MDN 将它标为 Baseline 2025，但旧设备、旧浏览器和旧 Node.js 仍可能没有该方法。上线前至少检查三件事：

1. 在目标运行时判断 typeof JSON.rawJSON === "function"，不支持时不要静默改用不精确的 Number。
2. 确定接收端是按字符串、BigInt 方案或高精度 JSON 解析器消费；“输出文本没有被舍入”不等于“对方解析后仍然精确”。
3. 把服务端字段协议固定下来：如果字段本质是 ID，字符串通常比 JSON 数字更容易跨语言；只有确需数字文本时才采用 raw JSON。

一个清晰的降级策略是：支持 raw JSON 时输出原始数字片段，不支持时保留字符串字段并让接口契约明确标注。不要在降级分支把大整数文本强转成 Number，否则兼容性看似通过，数据却已经改变。

相关问题

JSON.rawJSON 会把字符串自动变成数字吗？

不会。它只按参数中的 JSON 文本输出；传入带双引号的片段就是字符串，传入数字片段才是数字。

能不能用 JSON.rawJSON 传入一个对象？

不能。该 API 只接受表示原子值的合法 JSON 文本，对象和数组会触发 SyntaxError。

保留了数字文本，接收方就一定不会丢精度吗？

不一定。接收方如果把它解析为普通 JavaScript Number，仍可能舍入；跨服务协议应明确采用字符串或高精度类型。