JavaScript操作JSON只需JSON.parse()和JSON.stringify(),常见错误源于格式不合法、类型不兼容或忽略异步特性;须校验数据源、加try/catch、避免循环引用,并区分JSON字符串与JS对象。

JavaScript 操作 JSON 数据不需要额外库,核心就两件事:JSON.parse() 和 JSON.stringify()。用错函数、忽略类型转换、或在非标准 JSON 上强行解析,是 90% 的问题根源。
JSON.parse() 报错:Unexpected token 或 Unexpected end of JSON input
这是最常见错误,本质是传入的字符串不是合法 JSON 格式。注意:JavaScript 对象字面量(如 {name: 'Alice'})不是 JSON;JSON 要求键名和字符串值必须用双引号,且不支持尾逗号、注释、undefined、函数等。
- 检查原始数据来源:后端返回是否真为
Content-Type: application/json?前端拼接字符串时有没有漏掉引号或写错括号? - 用浏览器开发者工具的 Network 面板查看响应体原文,复制出来粘贴到 JSONLint 验证
- 不要对
null、undefined或已解析过的对象再调用JSON.parse()—— 它只接受字符串 - 安全做法:加 try/catch,避免整个流程崩掉:
try { const data = JSON.parse(rawString); } catch (e) { console.error('JSON 解析失败:', e.message); }
JSON.stringify() 后数据“消失”或变成空对象
JSON.stringify() 会忽略 undefined、函数、Symbol 类型的属性,也会跳过循环引用。如果输出是 "{}" 或 "null",大概率是输入值本身不可序列化。
- 传入
undefined、function、Symbol时,结果分别是"undefined"(顶层)、"null"(对象属性中)、undefined(被忽略) - 传入
NaN或Infinity,结果是"null" - 遇到循环引用(比如
obj.a = obj),直接抛TypeError: Converting circular structure to JSON - 需要保留特殊值?自己写 replacer 函数,例如过滤掉 undefined:
JSON.stringify(obj, (key, value) => value === undefined ? null : value)
修改 JSON 数据前必须先 parse,不能直接改字符串
JSON 是数据交换格式,本质是字符串。想增删改查字段,必须先转成 JavaScript 对象(或数组),操作完成后再 stringify 回去。直接字符串替换极易出错,且无法处理嵌套、转义、键名含特殊字符等情况。
立即学习“Java免费学习笔记(深入)”;
- 错误示范:
jsonStr.replace('"age":25', '"age":26')—— 如果 age 在多层嵌套里、或有其他字段也含 "age" 字符串,就挂了 - 正确流程:
const obj = JSON.parse(jsonStr); obj.age = 26; const newJson = JSON.stringify(obj); - 注意引用关系:如果对象很大,又只需要改一两个字段,
JSON.parse()会完整深拷贝一次,内存和性能需留意
从 fetch 获取 JSON 时,别忘了 .json() 是异步方法
很多人以为 fetch(url).then(res => res.json()) 返回的是解析好的对象,其实它返回的是 Promise。没 await 或没链好 then,拿到的就是 pending 状态的 Promise,不是数据本身。
- 错误:
const data = fetch('/api/user').then(r => r.json()); console.log(data); // Promise {} - 正确(async/await):
const res = await fetch('/api/user'); const data = await res.json(); // 注意这里也要 await - 正确(Promise 链):
fetch('/api/user') .then(res => res.json()) .then(data => console.log(data)); - 务必检查
res.ok,HTTP 错误状态码(如 404、500)不会导致 Promise reject,但res.json()仍会执行 —— 可能解析空响应体而报错
真正容易被忽略的点是:JSON 不是万能容器。时间用 Date 对象,二进制用 ArrayBuffer,复杂嵌套结构要考虑是否该用类或 Map 替代纯对象。别为了“看起来像 JSON”而硬塞所有东西进字符串来回 parse/stringify。











