JSON.stringify 的四个冷知识:键顺序、undefined、循环引用与 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 均一。)
- 点赞
- 收藏
- 关注作者
评论(0)