JSON.stringify的多种用法总结

定义

JSON.stringify() 方法将 JavaScript 值转换为 JSON 字符串。该方法可以接受三个参数：要序列化的JavaScript对象、替换值的函数、以及结果包含的对象的属性。通常我们只需要传入第一个参数即可。

默认用法

默认情况下，JSON.stringify() 方法会将对象中的所有属性都进行序列化，生成 JSON 字符串。

const obj = {
  name: 'John',
  age: 30,
  city: 'New York'
};

const jsonString = JSON.stringify(obj);
console.log(jsonString);
// 输出：{"name":"John","age":30,"city":"New York"}

以上代码中，我们将一个普通的 JavaScript 对象 obj 序列化成了 JSON 字符串，输出结果为 {"name":"John","age":30,"city":"New York"}。

序列化指定属性

有时候我们不想将对象中的所有属性都序列化，而只需要序列化其中的一部分属性。在这种情况下，我们需要传入第二个参数，以告诉函数哪些属性需要序列化。

const obj = {
  name: 'John',
  age: 30,
  city: 'New York'
};

const jsonString = JSON.stringify(obj, ['name', 'age']);
console.log(jsonString);
// 输出：{"name":"John","age":30}

以上代码中，我们只传入了 obj 对象以及包含要序列化的属性名的数组 ['name', 'age']，这样生成的 JSON 字符串就只包含了这两个属性对应的值。

修改序列化结果

有时候，我们想要修改序列化后的结果，比如将所有的字符串都转换成大写，或者只序列化对象中的部分值。这时就需要传入一个函数来进行替换。

const obj = {
  name: 'John',
  age: 30,
  city: 'New York'
};

const jsonString = JSON.stringify(obj, (key, value) => {
  if (typeof value === 'string') {
    return value.toUpperCase();
  }
  return value;
});
console.log(jsonString);
// 输出：{"name":"JOHN","age":30,"city":"NEW YORK"}

以上代码中，我们传入了一个函数作为第二个参数，该函数会对所有的字符串进行转换，将它们转换成大写形式，输出的结果为 {"name":"JOHN","age":30,"city":"NEW YORK"}。

支持缩进和空格

默认情况下，生成的 JSON 字符串没有格式，即所有数据都是连续的，难以阅读。我们可以通过传入第三个参数来支持缩进和空格，使得生成的字符串更易于阅读。

const obj = {
  name: 'John',
  age: 30,
  city: 'New York'
};

const jsonString = JSON.stringify(obj, null, 2);
console.log(jsonString);
// 输出：
// {
//   "name": "John",
//   "age": 30,
//   "city": "New York"
// }

以上代码中，我们传入了一个数字 2，这代表每个属性前面需要多少个空格缩进。输出的结果就比较易于阅读。

支持日期序列化

默认情况下，JSON.stringify() 方法无法对日期对象进行序列化，这时我们需要传入一个函数来进行替换。

const obj = {
  name: 'John',
  age: 30,
  birthday: new Date('1991-01-01')
};

const jsonString = JSON.stringify(obj, (key, value) => {
  if (value instanceof Date) {
    return value.toLocaleDateString();
  }
  return value;
});
console.log(jsonString);
// 输出：{"name":"John","age":30,"birthday":"1/1/1991"}

以上代码中，我们传入了一个函数作为第二个参数，该函数会对所有的日期进行处理，将它们转换成本地日期格式，输出的结果为 {"name":"John","age":30,"birthday":"1/1/1991"}。