JSON操作核心是JSON.parse()和JSON.stringify(),需防范非字符串输入、BOM字符、循环引用、特殊值丢失等问题,replacer/reviver是安全扩展点,严格遵循JSON规范(双引号、无尾逗号)。

JavaScript 里操作 JSON 几乎没有“教程”这回事——JSON.parse() 和 JSON.stringify() 就是全部核心,但用错地方、传错参数、忽略边界情况,才是实际出问题的根源。
JSON.parse() 报错:Unexpected token 或 Unexpected end of JSON input
这是最常见的解析失败,本质不是语法错误,而是传入了非字符串、空值、或带 BOM/不可见字符的字符串。
-
JSON.parse(null)或JSON.parse(undefined)直接抛TypeError;必须确保输入是string类型,可用typeof input === 'string' && input.trim()防御 -
后端返回空响应体(
"")或只含空白符("\n\t "),JSON.parse(" ")会报Unexpected token - 某些 API 返回带 UTF-8 BOM 的 JSON(如
\ufeff{"a":1}),需先用str.replace(/^\uFEFF/, '')清除 - 不要对已解析对象再调用
JSON.parse(),比如JSON.parse(JSON.parse('{"x":1}'))必然失败
JSON.stringify() 输出 undefined、null 或丢失数据
JSON.stringify() 不是无损序列化工具,它有明确的忽略规则和类型限制。
- 函数、
undefined、Symbol 值会被**静默丢弃**:JSON.stringify({a: 1, b: () => {}, c: undefined})→"{"a":1}" - 循环引用直接抛
TypeError: Converting circular structure to JSON,不能靠 try/catch 挺过去,得提前检测或用自定义 replacer 处理 - Date 对象被转成 ISO 字符串,但
new Date().toJSON()和JSON.stringify(new Date())行为一致;若需保留时间戳数字,要用replacer参数干预 -
JSON.stringify(undefined)返回undefined(不是字符串"undefined"),常导致拼接时意外变成"foo" + JSON.stringify(undefined) + "bar"→"foobar"
需要处理特殊值?别硬改 JSON,用 replacer 和 reviver
这两个参数是 JSON.stringify() 和 JSON.parse() 唯一合法的扩展点,比写正则或手动遍历安全得多。
本书是全面讲述PHP与MySQL的经典之作,书中不但全面介绍了两种技术的核心特性,还讲解了如何高效地结合这两种技术构建健壮的数据驱动的应用程序。本书涵盖了两种技术新版本中出现的最新特性,书中大量实际的示例和深入的分析均来自于作者在这方面多年的专业经验,可用于解决开发者在实际中所面临的各种挑战。 本书内容全面深入,适合各层次PHP和MySQL开发人员阅读,既是优秀的学习教程,也可用作参考手册。
立即学习“Java免费学习笔记(深入)”;
-
JSON.stringify(obj, (key, val) => key === 'date' ? val.getTime() : val)可把 Date 转时间戳 -
JSON.parse(str, (key, val) => key === 'ts' ? new Date(val) : val)可把数字时间戳还原为 Date - 注意:
reviver中的this指向父对象,且对顶层对象也调用一次(key为空字符串),要加判断避免误处理 - replacer 传数组可白名单字段:
JSON.stringify(obj, ['id', 'name']),比传函数更轻量
浏览器和 Node.js 的兼容性基本不用操心,但要注意 JSON5 不是 JSON
ES5 就已内置 JSON 全局对象,所有现代环境都支持。真正容易混淆的是:有人拿 JSON5(支持注释、单引号、尾逗号)当 JSON 用,结果在生产环境崩。
-
JSON.parse('{ "a": 1, }')在严格 JSON 下报错;JSON5 才允许尾逗号 -
JSON.parse("{'a': 1}")同样非法——JSON **只认双引号**,单引号是常见误判点 - Node.js 里
require('./config.json')是 CommonJS 行为,底层调用的是fs.readFileSync+JSON.parse,所以依然受 JSON 规范约束
真正难的从来不是“怎么调用”,而是你拿到的数据到底是不是 JSON 字符串、有没有被中间层悄悄改过格式、以及要不要在序列化前后做类型归一化——这些没法靠查文档解决,得看 network 面板、打日志、甚至抓包确认原始 payload。










