JSON.stringify() 的妙用

描述

JSON.stringify()的作用就是把 JavaScript 对象或数组或其他简单值转换为字符串。它还可以用于对象的深拷贝；对 JSON 字符串进行格式化（缩进）；在转换之前对值进行替换操作。

特殊类型的处理

JSON.stringify()遇到函数、日期等类型的值会进行特殊处理。为了让输出结果好看一些，在函数的第三个参数，指明字符串化后的结果缩进 2 个空格：

let jsonStr = JSON.stringify(
  {
    func: function () {},
    date: new Date(),
    unde: undefined,
    null: null,
    nan: NaN,
    infi: Infinity,
    infi0: -Infinity,
    regp: new RegExp(/Android|iPad/)
  },
  null,
  2
);

console.log(jsonStr);

输出结果如下所示：

{
  "date": "2022-08-31T13:34:25.223Z",
  "null": null,
  "nan": null,
  "infi": null,
  "infi0": null,
  "regp": {}
}

JSON.stringify()对以下类型的值进行特殊处理：

1. 函数：函数直接被忽略，不输出到字符串中。
2. Date：原本 new 一个日期的结果时 "Wed Aug 31 2022 21:38:37 GMT+0800 (中国标准时间)"，在被字符串化之后变成了如上格式。
3. undefined：undefined 直接被忽略，不输出。
4. null：null 就是 null 本身。
5. NaN：Nan 类型被转化成 null。
6. Infinity 和 -Infinity：都被转化成 null。
7. RegExp：RegExp 直接输出一个空对象 {}。

运用场景

对象深拷贝

通过=无法真正拷贝一个对象，而是引用对象的内存地址，详细请看JavaScript - 对象引用和复制。

JSON.stringify()和JSON.parse()一起搭配使用就可以深拷贝一个对象：

let obj = { age: 10, name: "XiaoMing" };
let copy = JSON.parse(JSON.stringify(obj));

obj.age = 12;
copy.age = 14;

console.log(obj.age, copy.age); // => 12, 14

修改原对象obj的 age 属性之后不影响深拷贝之后的对象copy的属性。

存储对象到 LocalStorage

window.localStorage.setItem(key, value)的两个参数都只接受字符串类型的值，如果强行把对象、数组存储到本地存储里面，最终的结果是：

所以，这时候就不得不把对象、数组进行字符化，也就是用JSON.stringify()：

let obj = { age: 10, name: "XiaoMing" };
window.localStorage.setItem("obj", JSON.stringify(obj));

然后就能正常显示出对象了：

如果从本地存储中拿这个值，不要忘记用JSON.parse()解析字符串。

第二个参数

第二个参数可以传递一个函数也可以传递一个数组，每一种类型都有不同的作用。传递函数我们可以对原对象做一个过滤处理或者其他的操作，传递数组就是输出结果只保留数组里面给的那几个 key 以及对应的值。

传递函数

函数接收两个值，key 和 value。key 不可以被改变，value 可以改变，且在改变之后必须要把 value 返回出去，否则无法执行下一步，导致最终只输出一个空。

let obj = { age: 10, name: "XiaoMing" };
let json = JSON.stringify(obj, (key, value) => {
  if (key === "age") {
    value = 20;
  }
  return value;
});
console.log(json);

打印结果：

传递数组

对于输出结果，我们要进行一些取舍，就可以传递一个数组，指定只输出哪些 key 和 value：

let obj = { age: 10, name: "XiaoMing" };
let json = JSON.stringify(obj, ["age"]);
console.log(json);

打印结果：

那如果希望字符化后的对象只保留除了一些 key 以外的所有其他 key 和 value 呢？我写了一个exclude函数，只针对于对象，去除不需要的对象字段，其余都保留输出：

function exclude(obj, exc) {
  for (let i in exc) {
    delete obj[exc[i]];
  }
  return Object.keys(obj);
}

let obj = { age: 10, name: "XiaoMing", school: "希望小学", address: "北京市朝阳区xxx号" };

let json = JSON.stringify(obj, exclude(obj, ["age", "address"]));

打印结果：

第三个参数

默认打印输出的 JSON 字符串是一行，没有任何缩进的，第三个参数就是缩进多少个空格。

JSON.stringify(obj, exclude(obj, ["age", "address"]), 2);

缩进 2 个字符的结果：

{
  "name": "XiaoMing",
  "school": "希望小学"
}