JSON是严格定义的文本格式,非JavaScript对象;核心方法为JSON.parse()和JSON.stringify(),需注意双引号、无注释、无undefined/函数/Symbol等限制,解析须try/catch,序列化会忽略非法值并无法处理循环引用。

JSON 不是 JavaScript 的子集,但 JavaScript 提供了原生支持来处理它;JSON.parse() 和 JSON.stringify() 是唯二需要掌握的核心方法,其余都是边界情况的应对。
JSON 是什么 —— 本质是文本格式,不是对象
JSON(JavaScript Object Notation)是一种轻量级的数据交换格式,它只包含字符串、数字、布尔值、null、数组和键值对对象,且所有字符串键必须用双引号包裹。它不是 JavaScript 对象,也不是任何语言的专有结构,而是一套严格定义的文本语法。
常见误解是把 { name: "Alice" } 当作 JSON —— 这其实是 JS 对象字面量,不是合法 JSON;正确写法是 {"name": "Alice"}(双引号 + 无注释 + 无尾逗号)。
容易踩的坑:
立即学习“Java免费学习笔记(深入)”;
-
JSON.parse()遇到单引号、尾逗号、undefined、函数、Symbol、Date 实例会直接抛错SyntaxError - 服务器返回的响应体是字符串,即使内容看起来像对象,也必须先用
JSON.parse()转换才能访问属性 - JSON 中没有日期类型,
new Date().toJSON()返回的是 ISO 字符串,解析后需手动转回 Date
JSON.parse() 怎么安全地解析数据
直接调用 JSON.parse() 在生产环境风险高,尤其当输入来源不可控(如用户输入、第三方 API)时。必须加 try/catch,并考虑可选的 reviver 参数做字段过滤或类型转换。
实操建议:
- 始终用
try { obj = JSON.parse(str); } catch (e) { /* 处理解析失败 */ }包裹解析逻辑 - reviver 函数可用于递归修改值,比如把所有
"2023-01-01"字符串自动转成Date:JSON.parse(jsonStr, (key, value) => { if (key === 'date' && typeof value === 'string') return new Date(value); return value; }); - 注意:reviver 会遍历所有层级,包括数组索引,
key为""表示根对象
JSON.stringify() 序列化时的典型陷阱
JSON.stringify() 会静默忽略 undefined、函数、Symbol,还会跳过原型链上的属性。它不处理循环引用,遇到就直接抛 TypeError: Converting circular structure to JSON。
使用场景与对策:
- 调试打印:用
JSON.stringify(obj, null, 2)格式化输出,但注意不能用于含函数的对象 - 过滤字段:传入数组作为第二个参数,如
JSON.stringify(user, ['name', 'email']) - 处理循环引用:需自行实现 replacer 函数记录已访问对象,或用第三方库如
flatted - 自定义序列化:replacer 函数中返回
undefined可排除该字段;返回其他值则用其替代原值
浏览器和 Node.js 的兼容性差异很小,但要注意历史版本
JSON 全局对象在 IE8+、Node.js 0.10+ 均原生支持,无需 polyfill。但老版本(如 IE7)需引入 json2.js。
现代开发中真正要关注的是语义层面的限制:
-
JSON.stringify(new Date())得到的是 ISO 字符串,不是 Date 对象本身 -
JSON.stringify(BigInt(123))在大多数环境会直接报错,需手动处理(如转成字符串) -
Map和Set默认无法被序列化,必须先转成普通对象或数组
这些不是环境兼容性问题,而是 JSON 规范本身的表达边界 —— 它只描述数据,不描述行为或类型元信息。











