JSON.stringify 的四个冷知识:键顺序、undefined、循环引用与 toJSON

举报
yd_251117598 发表于 2026/11/11 12:16:51 2026/11/11
【摘要】 JSON.stringify 有四个容易踩的行为:整数键优先排序、undefined 在对象/数组/顶层的三种待遇、循环引用直接抛 TypeError、对象可用 toJSON 定制输出。本文每个行为给出可直接运行的最小示例与对的工程事故场景。

JSON.stringify 看起是最没技术含量的 API:传个对象,出来个字符。但用它做日、缓存或报文时,下四个行为经常让结和预期不一样。逐个说清。

一、顺序:整键优先,按数值升序

JSON.stringify({ b: 1, 2: "two", a: 3, 1: "one" })
// {"1":"one","2":"two","b":1,"a":3}

整数索引键包括字字符串键)永远排在最前面并按数值升序,其余字符串键按插入顺由 JS 引擎的属枚举规则决定不是 JSON.stringify 自己定的但直接影响序列结果。依赖字段顺序固定的接口签名或快照比对,要特别注意。

二、undefined 有三种不同的待遇

JSON.stringify({ a: undefined })  // {}
JSON.stringify([undefined])       // [null]
JSON.stringify(undefined)         // undefined(不是字符串!

同一个 undefined:在对象里整个键被丢弃;在数组里变成 null;作为顶层输入时返回 undefined 而不是报。函数和 Symbol 在对象内的行为与 undefined 相(键被丢弃)。做日志时如果发现字段神秘消失,多半是。

三、循环引用直接抛错

const a = {}
a.self = a
JSON.stringify(a)  // TypeError: Converting circular structure to JSON

与很多尽力而的容错同,环引用会让 stringify 直接抛 TypeError。需要序列化可能含循环的结构时先用 WeakSet 自己做环测剪枝,或者换一支支持循环序列化库。DOM 节点、定时器句柄这类对象也常是隐藏循的来。

四、对可以实现自己的 toJSON

const money = {
  cents: 12345,
  toJSON() { return this.cents / 100 }
}
JSON.stringify({ price: money })  // {"price":123.45}

如果对象上有 toJSON 方法,stringify 会理该对,再对返回继续序列化。日对象能被序列化成 ISO 字符串正是走了这条通。金额、ID、温度这类带语义的封装值实现 toJSON,以让序列化环节自收口不用在每调用点手工转换。

小结

四行为对应四类事故:字段顺序变化破坏快照对、undefined 静默丢字段、引用掉日调、toJSON 让输出和源对象长得不一。都是几分钟内能复现的行为,比背结更有效的是在控制台把这几个例子跑一遍。

(本文为个人学习笔记,AI 助整理并已人工核对 API 行;示于 ECMA-262 规范描述的标准化行为主浏览 Node.js 均一。)

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。