JSON中的JSON.stringify()使用教程详细解-27149原创文章

JSON.stringify() 是 JavaScript 中一个用于将 JavaScript 对象或数组转换为 JSON 字符串的方法。它接收一个 JavaScript 对象或数组作为参数，返回一个字符串表示该对象的 JSON 形式。

JSON.stringify() 方法可以接受三个参数：

1. value：必需，表示要转换成 JSON 字符串的值。
2. replacer：可选，一个函数或者一个数组，用于过滤和转换要转换成 JSON 字符串的值。如果是一个函数，则它会被调用来转换 value 中的每个属性和值；如果是一个数组，则它会被用来过滤要转换成 JSON 字符串的属性。
3. space：可选，用于控制缩进的空格数量（最大为 10）。如果是一个数字，则表示每一级缩进的空格数；如果是一个字符串，则表示每一级缩进所用的字符串。

下面是一个示例：

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 对象转换为一个 JSON 字符串。

我们还可以通过传递一个 replacer 函数来选择要包含在 JSON 字符串中的属性。这个函数将在 JSON.stringify() 方法执行时被调用。例如：

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

const jsonString = JSON.stringify(obj, (key, value) => {
  if (key === "name") {
    return value.toUpperCase();
  }
  return value;
});

console.log(jsonString);
// 输出：{"name":"JOHN","age":30,"city":"New York"}

在上面的例子中，我们将 replacer 函数传递给 JSON.stringify() 方法。这个函数检查属性名是否为 “name”，如果是，则将属性值转换为大写字母。其他属性将不会被更改。

最后，我们还可以通过传递一个 space 参数来控制缩进。例如：

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"
}
*/

在上面的例子中，我们将 space 参数设置为 2，因此输出的 JSON 字符串中每个级别的缩进都有两个空格。

当 JSON.stringify() 方法序列化一个 JavaScript 对象时，它将对象中的属性转换为字符串并将它们作为 JSON 对象的键值对。对于对象的属性值，它将根据以下规则进行转换：

1. 如果属性值为一个简单数据类型（如字符串、数字、布尔值或 null），则该值会被转换为相应的 JSON 数据类型。
2. 如果属性值为一个对象或数组，则会递归调用 JSON.stringify() 方法来将其转换为 JSON 字符串。
3. 如果属性值为一个函数、undefined 或 symbol，则在序列化过程中会被忽略。

下面是一个包含数组的对象的示例：

const obj = {
  name: "John",
  age: 30,
  hobbies: ["reading", "traveling", "swimming"]
};

const jsonString = JSON.stringify(obj);

console.log(jsonString);
// 输出：{"name":"John","age":30,"hobbies":["reading","traveling","swimming"]}

当 JSON.stringify() 方法序列化一个 JavaScript 对象时，它将对象中的属性转换为字符串并将它们作为 JSON 对象的键值对。对于对象的属性值，它将根据以下规则进行转换：

1. 如果属性值为一个简单数据类型（如字符串、数字、布尔值或 null），则该值会被转换为相应的 JSON 数据类型。
2. 如果属性值为一个对象或数组，则会递归调用 JSON.stringify() 方法来将其转换为 JSON 字符串。
3. 如果属性值为一个函数、undefined 或 symbol，则在序列化过程中会被忽略。

下面是一个包含数组的对象的示例：

javascriptCopy codeconst obj = {
  name: "John",
  age: 30,
  hobbies: ["reading", "traveling", "swimming"]
};

const jsonString = JSON.stringify(obj);

console.log(jsonString);
// 输出：{"name":"John","age":30,"hobbies":["reading","traveling","swimming"]}

在上面的例子中，我们将一个包含一个数组属性的对象传递给 JSON.stringify() 方法。该方法将数组转换为 JSON 数组，并将其作为对象的一个属性。

当 JSON.stringify() 方法序列化一个对象时，它会遵循以下规则：

1. 如果对象具有 toJSON() 方法，则调用该方法并将其结果用作序列化的值。
2. 如果对象具有可枚举属性，则会对这些属性进行序列化。属性名将用作 JSON 对象的键，属性值将转换为 JSON 字符串并用作键值对的值。
3. 如果对象没有可枚举属性，则序列化结果将为一个空 JSON 对象 {}。

下面是一个具有 toJSON() 方法的示例

const obj = {
  name: "John",
  age: 30,
  toJSON() {
    return {
      name: this.name.toUpperCase(),
      age: this.age
    };
  }
};

const jsonString = JSON.stringify(obj);

console.log(jsonString);
// 输出：{"name":"JOHN","age":30}

在上面的例子中，我们将一个具有 toJSON() 方法的对象传递给 JSON.stringify() 方法。该方法调用 toJSON() 方法并将其返回值用作序列化的值。

最后，需要注意的是，JSON.stringify() 方法不能序列化循环引用。如果对象包含循环引用，则会引发 TypeError 异常。例如：

const obj = {
  name: "John",
  age: 30,
  friends: []
};

obj.friends.push(obj);

JSON.stringify(obj); // TypeError: Converting circular structure to JSON

在上面的例子中，我们将一个包含自己作为属性值的对象传递给 JSON.stringify() 方法。该方法无法序列化这个对象，因为它包含一个循环引用。因此，它会引发 TypeError 异常。

另外，JSON.stringify() 还有两个可选参数：replacer 和 space。

replacer 参数是一个函数或数组，用于控制序列化过程中要包含哪些属性。如果 replacer 参数是一个函数，则它将被调用一次，传递属性名和属性值作为参数，并应返回一个值，该值将用作序列化结果中的该属性值。如果 replacer 参数是一个数组，则它应包含要序列化的属性名。

下面是一个使用 replacer 函数的示例：

const obj = {
  name: "John",
  age: 30,
  hobbies: ["reading", "traveling", "swimming"]
};

const jsonString = JSON.stringify(obj, (key, value) => {
  if (key === "age") {
    return undefined; // 忽略 age 属性
  }
  return value;
});

console.log(jsonString);
// 输出：{"name":"John","hobbies":["reading","traveling","swimming"]}

在上面的例子中，我们使用 replacer 函数忽略了对象中的 age 属性。

space 参数用于控制序列化结果中的缩进和间距。如果 space 参数是一个整数，则它指定要用于缩进的空格数。如果 space 参数是一个字符串，则它指定要用作缩进的字符串。如果 space 参数为 null，则没有缩进。默认情况下，space 参数为 undefined，表示使用默认缩进。

下面是一个使用 space 参数的示例：

const obj = {
  name: "John",
  age: 30,
  hobbies: ["reading", "traveling", "swimming"]
};

const jsonString = JSON.stringify(obj, null, 2);

console.log(jsonString);
// 输出：
// {
//   "name": "John",
//   "age": 30,
//   "hobbies": [
//     "reading",
//     "traveling",
//     "swimming"
//   ]
// }

在上面的例子中，我们使用 space 参数将序列化结果格式化为带有缩进的多行字符串。

如果你需要将 JavaScript 对象转换成 JSON 字符串，JSON.stringify() 是一个非常有用的方法。但是，需要注意的是，如果你的对象包含循环引用，JSON.stringify() 将无法序列化该对象，而会抛出一个错误。

下面是一个包含循环引用的示例：

const obj1 = {
  name: "John",
  age: 30
};
const obj2 = {
  name: "Mary",
  age: 25,
  spouse: obj1
};
obj1.spouse = obj2;

const jsonString = JSON.stringify(obj1); // 抛出错误

在上面的例子中，obj1 和 obj2 彼此引用，形成了一个循环引用。当我们尝试将 obj1 转换为 JSON 字符串时，JSON.stringify() 将无法完成该操作，并抛出一个错误。

如果你的对象可能包含循环引用，你可以使用一个第三方库，如 circular-json 或 flatted，来解决该问题。这些库提供了一种方法来序列化包含循环引用的对象。

在使用 JSON.stringify() 时，还需要注意序列化的结果是否包含 JavaScript 对象中的所有属性。例如，如果对象中有一个属性的值为 undefined，该属性将被序列化为 null。如果对象中包含一个函数，该函数将被忽略，并且在序列化结果中不会包含该函数。

总之，JSON.stringify() 是将 JavaScript 对象转换为 JSON 字符串的常用方法。它支持多种选项，可用于控制序列化的方式和结果。但是需要注意，如果对象包含循环引用，则 JSON.stringify() 将无法序列化该对象，而会抛出一个错误。

另外，需要注意的是，JSON.stringify() 不支持序列化 Date、RegExp、Error 对象和 undefined 值。在序列化这些类型的值时，JSON.stringify() 会将它们序列化为 null。

下面是一个包含 Date、RegExp 和 undefined 的示例：

const obj = {
  date: new Date(),
  regExp: /[a-z]+/gi,
  undefinedValue: undefined
};

const jsonString = JSON.stringify(obj);

console.log(jsonString);
// 输出：{"date":null,"regExp":{},"undefinedValue":null}

在上面的例子中，我们将一个包含 Date、RegExp 和 undefined 的对象转换为 JSON 字符串。由于这些类型的值无法被序列化，JSON.stringify() 将它们转换为 null。

最后，需要注意的是，JSON.stringify() 可能会在某些情况下导致性能问题。特别是在处理大型对象或嵌套层次较深的对象时，序列化可能会非常耗时。如果你需要处理大型或复杂的数据结构，请考虑使用流式 JSON 库或其他序列化库。

除了上面提到的一些限制和注意事项之外，JSON.stringify() 还有一些非常有用的选项，可用于控制序列化的方式和结果。

下面是一些常用的选项：

• replacer：一个函数或数组，用于控制序列化过程中哪些属性应该被序列化。如果传递一个函数，则该函数将接收对象的键和值作为参数，并返回一个序列化后的值。如果传递一个数组，则数组中指定的属性将被序列化。
• space：一个字符串或数字，用于控制序列化结果中的缩进和换行。如果传递一个数字，则表示缩进的空格数；如果传递一个字符串，则表示缩进的字符。默认情况下，不使用缩进或换行符。
• toJSON：一个函数，用于在对象序列化时自定义转换过程。如果对象具有 toJSON() 方法，则该方法将被调用，并使用其返回值进行序列化。如果没有 toJSON() 方法，则将使用对象的默认序列化方式。

下面是一个使用 replacer 和 space 选项的示例：

const obj = {
  name: "John",
  age: 30,
  city: "New York",
  toJSON: function() {
    return {
      name: this.name,
      age: this.age
    };
  }
};

const jsonString = JSON.stringify(obj, ["name", "age"], 2);

console.log(jsonString);
// 输出：
// {
//   "name": "John",
//   "age": 30
// }

在上面的例子中，我们使用 replacer 选项指定只序列化 name 和 age 属性，并使用 space 选项指定两个空格作为缩进字符。我们还在对象中定义了一个 toJSON() 方法，该方法将对象转换为仅包含 name 和 age 属性的新对象。最终，JSON.stringify() 将返回一个格式化的 JSON 字符串，仅包含 name 和 age 属性。

总之，JSON.stringify() 是一个非常有用的方法，可用于将 JavaScript 对象转换为 JSON 字符串。

系统教程导航：

• JSON 语法-27149原创文章
• JSON vs XML-27149原创文章
• JSON 对象-27149原创
• JSON 数组-27149原创文章
• JSON.parse()-27149原创文章
• JSON.stringify()-27149原创文章
• JSON 使用-27149原创文章