javascript中JSON如何解析与序列化_JSON.stringify参数有哪些?

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

JSON.parse 会抛错?先确认输入是不是合法字符串

直接用 JSON.parse 解析非字符串(比如 nullundefined、对象本身)必然报错: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 可以是数组(指定要保留的键名)或函数(自定义序列化逻辑)。传数组时,若原对象有 idtoken,但只写 ["id", "name"],则 token 被忽略
  • space 控制缩进:数字表示空格数(如 2),字符串如 "\t""--" 也会被用作缩进前缀,影响可读性但不改变语义
  • 注意:replacer 函数中返回 undefined 会排除该字段;返回 functionundefined 值本身会被跳过(不报错,但消失)

常见误用:把 replacer 当成过滤条件传布尔值或字符串——它只认数组或函数。

哪些值 JSON.stringify 会静默丢弃

不是所有 JS 值都能被序列化。以下情况不会报错,但对应字段「消失」或被替换:

  • undefinedFunctionSymbol 类型的属性值 → 整个键值对被忽略(对象中)或转为 null(数组中)
  • NaNInfinity → 转为 null
  • 循环引用的对象(如 a.b = a)→ 直接抛错:TypeError: Converting circular structure to JSON
  • Date 对象 → 自动调用 .toJSON(),转为 ISO 字符串(如 "2025-10-05T12:00:00.000Z"

如果需要保留函数或特殊类型,必须靠 replacer 函数手动处理,或换用其他序列化方案(如 structuredClone + 自定义序列化器)。

浏览器和 Node.js 的兼容性差异点

JSON.stringifyJSON.parse 在现代环境基本一致,但要注意两个细节:

  • IE8 及更早版本不支持 JSON 全局对象(需引入 json2.js 垫片)
  • Node.js 早期版本(BigInt 抛错;现在仍不原生支持(JSON.stringify(1n)TypeError),必须用 replacer 显式转换
  • 某些嵌入式 JS 引擎(如 QuickJS)可能不实现 toJSON 隐式调用,导致 DateMap 序列化异常

如果你的代码要跑在低版本环境或非标准引擎里,别假设 JSON.stringify 能“自动处理一切”——尤其是日期、大数、嵌套结构这类边界情况。