javascript如何将对象转为JSON_JSON.stringify方法有哪些参数?

14次阅读

jsON.stringify(value, replacer, space) 有三个参数:replacer可为数组(精确匹配首层字段)或函数(处理函数/undefined/symbol循环引用等),space控制缩进(数字或字符串,0/””/false生成紧凑格式)。

javascript如何将对象转为JSON_JSON.stringify方法有哪些参数?

json.stringify 的基本用法和两个可选参数

直接调用 JSON.stringify(obj) 能把大多数普通对象转成 JSON 字符串,但遇到函数、undefined、Symbol、循环引用会出问题。它实际支持三个参数:JSON.stringify(value, replacer, space),其中后两个是可选的。

  • replacer 可以是数组(指定要保留的属性名)或函数(自定义序列化逻辑),传 NULL 或不传表示不过滤
  • space 控制缩进,可以是数字(空格数)或字符串(如 "t"),传 0""false 会生成紧凑格式(无换行无空格)
  • 注意:replacer 函数中 this 指向父级对象,返回 undefined 会排除当前键,返回其他值则使用该值替代原值

replacer 数组用法:只保留指定字段

当只需要导出对象的某些字段时,用字符串数组最简洁。数组里写的字段名必须完全匹配,大小写敏感,且不会递归生效——只作用于第一层。

const user = { name: "Alice", age: 30, token: "abc123", role: "admin" }; console.log(JSON.stringify(user, ["name", "age"], 2)); // 输出: // { //   "name": "Alice", //   "age": 30 // }
  • 如果数组里写了不存在的字段(如 ["email"]),对应字段不会出现在结果中,也不会报错
  • 嵌套对象的字段不会被这个顶层 replacer 影响,除非你在 replacer 函数里手动处理
  • 不能用正则或通配符,只能精确列出字段名

replacer 函数用法:跳过函数/undefined/Symbol,处理循环引用

默认情况下,JSON.stringify 遇到函数、undefinedSymbol 会静默丢弃;遇到循环引用直接抛错 TypeError: Converting circular structure to JSON。用 replacer 函数可以拦截并转换这些值。

const obj = { a: 1, b: () => {}, c: undefined, d: Symbol("x") }; const seen = new WeakMap();  function replacer(key, value) {   if (typeof value === "function" || value === undefined || typeof value === "symbol") {     return null; // 统一转成 null,避免被删掉   }   if (typeof value === "object" && value !== null) {     if (seen.has(value)) return "[Circular]";     seen.set(value, true);   }   return value; }  console.log(JSON.stringify(obj, replacer)); // {"a":1,"b":null,"c":null,"d":null}
  • 必须自己管理循环引用检测,WeakMap 是常用方式;JSON.stringify 不内置此功能
  • 返回 undefined 会导致整个键被忽略(不是变成 null),这点容易误判
  • dateregexp 等内置对象,replacer 函数能拿到它们的原始值,可手动转成字符串(如 value instanceof Date ? value.toISOString() : value

space 参数影响输出格式和调试体验

space 看似只是美化,但实际会影响日志可读性、网络传输体积,甚至某些后端解析行为(比如严格模式下不接受尾随逗号,而缩进格式更容易暴露这类问题)。

立即学习Java免费学习笔记(深入)”;

  • 2 最常用,适合开发环境查看结构;传 4"  " 也行,但别用中文空格或全角字符
  • 生产环境一般用 0 或省略,减少体积;但若需人肉排查接口响应,临时加 2 很有用
  • 传字符串时,长度超过 10 会被截断,且每个层级都重复该字符串,例如 JSON.stringify({a:1}, null, "→ ") 会生成带箭头缩进的结果

真正麻烦的不是参数本身,而是默认行为:它不报错地吞掉函数和 undefined,还对循环引用直接崩掉。线上出问题时,往往是因为忘了检查数据里有没有意外的函数或引用闭环。

text=ZqhQzanResources