JSON是一种文本语法规范,非JavaScript数据类型,仅支持双引号键名、字符串、数字、布尔值、null、数组和嵌套对象,不支持函数、undefined等;解析失败多因输入非字符串、非法字符或HTML响应;stringify会静默丢弃不可序列化值并导致精度丢失。

JSON 是 JavaScript 原生支持的数据交换格式,不是对象,也不是字符串,而是一种**文本语法规范**
很多人误以为 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}'全部非法 - 服务器返回的是 HTML(如 500 错误页)或带 BOM 的 UTF-8 文本,也会导致解析失败
- 需要容错时,可封装安全解析函数:
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)或字符串(如' '),但生产环境应避免美化输出,影响体积和性能 - 无法序列化的值会被静默忽略:
undefined、函数、Symbol 在对象属性中直接消失;Date对象变成 ISO 字符串;NaN和Infinity变成null - 循环引用会直接抛
TypeError: Converting circular structure to JSON
遇到循环引用或特殊类型,需手动预处理,比如用 Map/Set 转数组、用 toJSON() 方法定制序列化逻辑。
立即学习“Java免费学习笔记(深入)”;
浏览器和 Node.js 中的兼容性与替代方案
JSON.parse() 和 JSON.stringify() 在现代环境(IE8+、Node.js 0.12+)中完全可用,无需 polyfill。但要注意:
- IE8 仅支持全局
JSON对象,不支持JSON.parse的第二个参数(reviver) - 超大 JSON(百 MB 级)解析可能阻塞主线程,前端可用
Web Worker搬运,后端 Node.js 可用流式解析库如jsonparse或stream-json - 需要保留
undefined或函数?那已超出 JSON 范畴,应改用structuredClone()(现代浏览器)、MessageChannel序列化,或专用格式如 BSON、Protocol Buffers
真正容易被忽略的是:JSON 规范里没有“整数”和“浮点数”之分,所有数字都是 IEEE 754 双精度值——所以 9007199254740993 这样的大整数在解析后可能精度丢失,后端若依赖精确大整数,必须传字符串。










