JSON是一种文本语法规范,非JavaScript数据类型,仅支持双引号键名、字符串、数字、布尔值、null、数组和嵌套对象,不支持函数、undefined等;解析失败多因输入非字符串、非法字符或HTML响应;stringify会静默丢弃不可序列化值并导致精度丢失。
很多人误以为 JSON 是 JavaScript 的一种数据类型,其实它只是用 JavaScript 语法风格定义的轻量级数据格式(RFC 8259)。它只允许双引号包裹的键名、字符串值、数字、布尔值、null、数组和嵌套对象——不支持函数、undefined、日期对象、正则、循环引用等。这意味着你不能直接把任意 JS 对象丢给 JSON.parse(),也不能指望 JSON.stringify() 忠实还原所有 JS 类型。
JSON.parse() 解析失败的常见原因和应对方式解析失败几乎都抛出 SyntaxError,但错误信息往往模糊。关键要检查:
JSON.parse({}) 会报错,必须是 JSON.parse('{"a":1}')
undefined 或 NaN 字面量都不合法:例如 '{a: 1}'、'{"a": 1,}'、'{"a": undefined}' 全部非法function safeParse(jsonStr) {
try {
return JSON.parse(jsonStr);
} catch (e) {
console.warn('JSON parse failed:', e.message);
return null;
}
}
JSON.stringify() 的坑:丢失数据和意外行为这个函数看似简单,但几个参数和隐式转换常引发问题:
replacer 可以是数组(白名单键名)或函数(自定义序列化逻辑),但函数中 this 指向父对象,且返回 undefined 会跳过该属性space 控制缩进,传数字(如 2)或字符串(如 ' '),但生产环境应避免美化输出,影响体积和性能undefi
ned、函数、Symbol 在对象属性中直接消失;Date 对象变成 ISO 字符串;NaN 和 Infinity 变成 null
TypeError: Converting circular structure to JSON
遇到循环引用或特殊类型,需手动预处理,比如用 Map/Set 转数组、用 toJSON() 方法定制序列化逻辑。
JSON.parse() 和 JSON.stringify() 在现代环境(IE8+、Node.js 0.12+)中完全可用,无需 polyfill。但要注意:
JSON 对象,不支持 JSON.parse 的第二个参数(reviver)Web Worker 搬运,后端 Node.js 可用流式解析库如 jsonparse 或 stream-json
undefined 或函数?那已超出 JSON 范畴,应改用 structuredClone()(现代浏览器)、MessageChannel 序列化,或专用格式如 BSON、Protocol Buffers真正容易被忽略的是:JSON 规范里没有“整数”和“浮点数”之分,所有数字都是 IEEE 754 双精度值——所以 9007199254740993 这样的大整数在解析后可能精度丢失,后端若依赖精确大整数,必须传字符串。