JSON.stringify()易踩坑:日期变ISO字符串、函数/undefined被删、Symbol不可见、循环引用报错、BigInt需手动转字符串;需用replacer预处理,封装函数可规避多数问题。

JavaScript中JSON.stringify()看似简单,但实际使用时容易踩坑——比如日期变空对象、函数丢失、循环引用报错、undefined被忽略、BigInt报错等。掌握这些边界情况,才能安全可靠地序列化对象。
日期对象会变成ISO字符串,不是原始Date实例
JSON.stringify()自动将Date对象转为ISO格式字符串(如"2024-05-20T08:30:00.000Z"),反序列化后是字符串而非Date。若需保留日期类型,得手动处理:
- 序列化前用
toJSON()方法自定义输出(Date原生支持该方法) - 或在
replacer函数中识别Date并转成时间戳:typeof value === 'object' && value instanceof Date ? value.getTime() : value - 反序列化后,再根据字段名或值特征把字符串/数字重新转为
Date
函数、undefined、Symbol 和 循环引用直接被忽略或报错
默认行为下:
- 函数和
undefined字段会被静默删除(不报错,但数据丢失) -
Symbol键名的属性完全不可见(连replacer也收不到) - 遇到对象循环引用(如
obj.a = obj)会抛出TypeError: Converting circular structure to JSON
应对方式:用replacer预处理过滤非法值;对循环引用,可借助第三方库(如flatted)或自行实现引用标记逻辑(例如用WeakMap记录已遍历对象)。
立即学习“Java免费学习笔记(深入)”;
BigInt 类型直接报错,必须显式转换
JSON.stringify({x: 1n})会抛出TypeError: Do not know how to serialize a BigInt。不能依赖默认行为,必须主动转换:
- 在
replacer中检测typeof value === 'bigint',返回value.toString()(推荐)或Number(value)(注意精度丢失风险) - 避免全局替换,只对明确含
BigInt的字段做处理,防止误转其他数字
空格与换行影响可读性,但不影响语义;特殊字符需注意编码
JSON.stringify(obj, null, 2)加缩进便于调试,但生产环境建议省略(减小体积)。另外:
- 中文、emoji 等 Unicode 字符会被正确编码(如
"你好"→"\u4f60\u597d"),无需额外处理 - 若后端要求严格 ASCII,可用
JSON.stringify(obj, null, 0).replace(/[u007F-uFFFF]/g, ...)二次转义(极少需要) -
undefined作为数组元素时变成null(JSON.stringify([1, undefined, 3])→[1,null,3]),这点常被忽略
不复杂但容易忽略——关键是在序列化前想清楚:哪些字段必须保留、哪些要过滤、哪些需转换类型、是否涉及循环或特殊值。加一层薄薄的封装函数,就能避开大多数陷阱。


















