JSON.parse仅接受合法JSON字符串,非字符串输入会报错;JSON.stringify的replacer参数控制字段筛选,space控制缩进;undefined、Function、Symbol等值会被静默丢弃。

JSON.parse 会抛错?先确认输入是不是合法字符串
直接用 JSON.parse 解析非字符串(比如 null、undefined、对象本身)必然报错:Unexpected token u in JSON at position 0 或类似提示。它只接受严格格式的 JSON 字符串,不能处理 JS 对象字面量或带单引号的字符串。
- ✅ 正确:
JSON.parse('{"name":"Alice","age":30}') - ❌ 错误:
JSON.parse({name:"Alice"})(传了对象,不是字符串) - ❌ 错误:
JSON.parse("{'name':'Alice'}")(单引号不合法) - ❌ 错误:
JSON.parse(undefined)(undefined转成字符串是"undefined",不是 JSON)
安全做法是加一层类型判断和 trim:
function safeParse(str) {
if (typeof str !== 'string' || !str.trim()) return null;
try {
return JSON.parse(str.trim());
} catch (e) {
return null;
}
}
JSON.stringify 的三个参数分别控制什么
JSON.stringify(value, replacer, space) 中,后两个参数可选,但作用关键:
-
replacer可以是数组(指定要保留的键名)或函数(自定义序列化逻辑)。传数组时,若原对象有id和token,但只写["id", "name"],则token被忽略 -
space控制缩进:数字表示空格数(如2),字符串如"\t"或"--"也会被用作缩进前缀,影响可读性但不改变语义 - 注意:
replacer函数中返回undefined会排除该字段;返回function或undefined值本身会被跳过(不报错,但消失)
常见误用:把 replacer 当成过滤条件传布尔值或字符串——它只认数组或函数。
立即学习“Java免费学习笔记(深入)”;
哪些值 JSON.stringify 会静默丢弃
不是所有 JS 值都能被序列化。以下情况不会报错,但对应字段「消失」或被替换:
-
undefined、Function、Symbol类型的属性值 → 整个键值对被忽略(对象中)或转为null(数组中) -
NaN、Infinity→ 转为null - 循环引用的对象(如
a.b = a)→ 直接抛错:TypeError: Converting circular structure to JSON -
Date对象 → 自动调用.toJSON(),转为 ISO 字符串(如"2023-10-05T12:00:00.000Z")
如果需要保留函数或特殊类型,必须靠 replacer 函数手动处理,或换用其他序列化方案(如 structuredClone + 自定义序列化器)。
浏览器和 Node.js 的兼容性差异点
JSON.stringify 和 JSON.parse 在现代环境基本一致,但要注意两个细节:
- IE8 及更早版本不支持
JSON全局对象(需引入json2.js垫片) - Node.js 早期版本(BigInt 抛错;现在仍不原生支持(
JSON.stringify(1n)→TypeError),必须用replacer显式转换 - 某些嵌入式 JS 引擎(如 QuickJS)可能不实现
toJSON隐式调用,导致Date或Map序列化异常
如果你的代码要跑在低版本环境或非标准引擎里,别假设 JSON.stringify 能“自动处理一切”——尤其是日期、大数、嵌套结构这类边界情况。











