详解JSON.stringify()的5个秘密特性

JSON.stringify() 是将一个 JavaScript 对象或值转换为 JSON 字符串的方法。但是，如果您不了解 JSON.stringify() 的所有“秘密特性”，则无法在实际开发中充分利用它的性能和灵活性。以下是5个最重要的“秘密特性”。

1. JSON.stringify() 可以通过选项参数输出特定的 JSON 字符串格式

在使用 JSON.stringify() 转换对象时，您可以传递一个选项参数（可以是一个对象）。这使您可以修改组合生成的 JSON 字符串的行为。例如，您可以使用选项参数缩进并统一生成的 JSON 字符串中属性/值对的执行方式。以下是一个示例：

const person = {
  name: "Alice",
  age: 30,
  interests: ["coding", "reading"],
  address: {
    city: "Shanghai",
    country: "China"
  }
};

const jsonStr = JSON.stringify(person, null, 2); 
console.log(jsonStr);

这段代码会将 person 对象转换成 JSON 格式，其中第二个参数 null 指定了过滤器函数（这个示例不使用过滤器）。第三个参数 2 指示输出应该使用两个空格的缩进格式，输出的结果如下：

{
  "name": "Alice",
  "age": 30,
  "interests": [
    "coding",
    "reading"
  ],
  "address": {
    "city": "Shanghai",
    "country": "China"
  }
}

2. JSON.stringify() 可以处理“循环引用”的情况

如果您尝试将有循环引用的对象（例如，一个对象引用了一个对象，而前面的对象又引用了后者）编码为 JSON 字符串，您会遇到错误。但是，如果您使用 JSON.stringify()，将对象作为“引用”进行编码，可以避免这个问题，并确保循环引用得到正确处理。以下是一个示例：

const person = {
  name: "Alice",
  friends: []
};

person.friends.push(person);

const jsonStr = JSON.stringify(person); 
console.log(jsonStr);

这段代码会输出以下 JSON 字符串：

{
  "name": "Alice",
  "friends": [
    "[Circular ~]"
  ]
}

注意，这里的 [Circular ~] 表示对该对象的引用。

3. JSON.stringify() 可以替换对象属性的值

您可以提供一个转换函数，该函数将处理对象期望序列化的属性值（例如，剥离一个影响性能的日期对象）。以下是一个示例：

const person = {
  name: "Alice",
  age: 30,
  dateOfBirth: new Date("1993/01/01")
};

const jsonStr = JSON.stringify(person, function replacer(key, value) {
  if (key === "dateOfBirth") {
    return value.getFullYear();
  }
  return value;
}, 2); 
console.log(jsonStr);

这段代码会将 person 对象转换成 JSON 格式，受到转换函数的影响，dateOfBirth 属性的值被替换为出生日期的年份。输出的结果如下：

{
  "name": "Alice",
  "age": 30,
  "dateOfBirth": 1993
}

4. JSON.stringify() 可以序列化函数

JSON.stringify() 没有办法序列化函数。但是，您可以增加一个选项参数，获得函数源代码的序列化字符串。以下是一个示例：

const func = function sayHello() { console.log("Hello, world!"); }
const jsonStr = JSON.stringify(func, function(key, value) {
  if (typeof value === 'function') {
    return value.toString();
  }
  return value;
}, 2);

console.log(jsonStr);

这段代码将输出以下 JSON 字符串：

"function sayHello() { console.log(\"Hello, world!\"); }"

5. JSON.stringify() 可以重写原型的 toJSON 方法

您可以轻松地改写对象原型的 toJSON 方法，以自定义在使用 JSON.stringify() 序列化该对象时的行为。以下是一个示例：

class Person {
  constructor(name, age) {
    this.name = name;
    this.age = age;
  }
  toJSON() {
    return {
      name: this.name.toUpperCase(),
      age: this.age
    };
  }
}

const alice = new Person("Alice", 30);
const jsonStr = JSON.stringify(alice, null, 2); 
console.log(jsonStr);

这段代码会将带有 toJSON() 的 Person 类型的对象转换成 JSON 格式。受到 toJSON() 的影响，输出的结果如下：