js如何转成json

JavaScript 对象/值转换为 JSON 字符串的完整指南**

在 JavaScript 开发中，我们经常需要将 JavaScript 的对象或值转换为 JSON（JavaScript Object Notation）字符串格式，JSON 是一种轻量级的数据交换格式，易于人阅读和编写，也易于机器解析和生成，它被广泛用于 Web 应用程序的数据传输（与服务器进行 API 交互）和配置文件。

本文将详细介绍 JavaScript 中将数据转换为 JSON 字符串的主要方法、注意事项以及常见问题。

核心方法：`JSON.stringify()`

JavaScript 提供了一个内置的全局对象 JSON，其中包含 stringify() 方法，这是将 JavaScript 对象或值转换为 JSON 字符串的标准方式。

基本语法

JSON.stringify(value[, replacer[, space]])

value: 必需参数，要转换的 JavaScript 值，通常是对象或数组。
replacer: 可选参数，可以是一个函数或一个数组，用于控制如何转换结果。
space: 可选参数，一个字符串或数字，用于美化输出 JSON 字符串，增加缩进和换行，使其更易读。

简单示例

const user = {
  name: "张三",
  age: 30,
  isAdmin: false,
  hobbies: ["阅读", "旅行", "编程"],
  address: {
    city: "北京",
    district: "朝阳区"
  }
};
// 将 user 对象转换为 JSON 字符串
const jsonString = JSON.stringify(user);
console.log(jsonString);
// 输出（不包含空格）：
// {"name":"张三","age":30,"isAdmin":false,"hobbies":["阅读","旅行","编程"],"address":{"city":"北京","district":"朝阳区"}}
console.log(typeof jsonString); // 输出: string

`JSON.stringify()` 的进阶用法

使用 `replacer` 函数

replacer 是一个函数，它会被序列化的每个键值对调用，这个函数的返回值将被用作该键值对的值，或者如果返回 undefined，则该键值对将被排除。

const user = {
  name: "张三",
  age: 30,
  password: "123456", // 我们不希望密码出现在 JSON 中
  isAdmin: false
};
// 使用 replacer 函数过滤掉 password 属性
const filteredJsonString = JSON.stringify(user, (key, value) => {
  if (key === "password") {
    return undefined; // 过滤掉 password
  }
  return value; // 其他属性正常返回
});
console.log(filteredJsonString);
// 输出：{"name":"张三","age":30,"isAdmin":false}

使用 `replacer` 数组

replacer 也可以是一个数组，数组元素是字符串，表示要包含在 JSON 字符串中的属性名。

const user = {
  name: "张三",
  age: 30,
  email: "zhangsan@example.com",
  phone: "13800138000"
};
// 只包含 name 和 email 属性
const selectedJsonString = JSON.stringify(user, ["name", "email"]);
console.log(selectedJsonString);
// 输出：{"name":"张三","email":"zhangsan@example.com"}

使用 `space` 参数美化输出

space 参数可以让你生成的 JSON 字符串更具可读性，它可以是：

数字: 指定缩进用的空白字符数，上限是 10，超过 10 会被视为 10。
字符串: 用作缩进的字符串（最多前 10 个字符）。

const user = {
  name: "张三",
  age: 30,
  hobbies: ["阅读", "旅行", "编程"]
};
// 使用数字缩进
const prettyJsonWithNumber = JSON.stringify(user, null, 2);
console.log(prettyJsonWithNumber);
/*
输出：
{
  "name": "张三",
  "age": 30,
  "hobbies": [
    "阅读",
    "旅行",
    "编程"
  ]
}
*/
// 使用字符串缩进
const prettyJsonWithString = JSON.stringify(user, null, "--");
console.log(prettyJsonWithString);
/*
输出：
{
--"name": "张三",
--"age": 30,
--"hobbies": [
----"阅读",
----"旅行",
----"编程"
--]
}
*/

`JSON.stringify()` 的注意事项与局限性

并非所有的 JavaScript 数据类型都能被成功转换为 JSON。JSON.stringify() 在转换时会遵循以下规则：

可转换的数据类型:
- 对象（Object，包括普通对象、数组、Map、Set 等，但 Map 和 Set 需要特殊处理）
- 字符串（String）
- 数字（Number）
- 布尔值（Boolean）
- null

会被忽略或转换为 null 的数据:

函数: 函数属性会被忽略。

const obj = { name: "test", func: function() { console.log("hello"); } };
console.log(JSON.stringify(obj)); // 输出: {"name":"test"}

undefined: undefined 值会被忽略。undefined 是数组中的一个元素，它会被转换为 null。

const obj = { name: "test", undefProp: undefined };
console.log(JSON.stringify(obj)); // 输出: {"name":"test"}
const arr = [1, undefined, "hello"];
console.log(JSON.stringify(arr)); // 输出: [1,null,"hello"]

Symbol: Symbol 类型的键和值都会被忽略。

const obj = { [Symbol("id")]: 123, name: "test" };
console.log(JSON.stringify(obj)); // 输出: {"name":"test"}

循环引用: 如果对象中存在循环引用（即对象的某个属性间接或直接引用了对象本身），JSON.stringify() 会抛出错误 TypeError: Converting circular structure to JSON。
```
const obj = {};
obj.self = obj; // 循环引用
// JSON.stringify(obj); // 这行代码会抛出错误
```

处理特殊对象类型（Map, Set, Date）

对于一些特殊的 JavaScript 对象，JSON.stringify() 有默认行为，但通常不是我们想要的。

Date 对象: 默认情况下，Date 对象会被转换为 ISO 日期字符串（调用 toISOString()）。

const data = { event: "会议", time: new Date() };
console.log(JSON.stringify(data));
// 输出类似：{"event":"会议","time":"2023-10-27T10:30:00.123Z"}

Map 和 Set: 默认情况下，Map 和 Set 会被空对象替代。

const map = new Map([['a', 1], ['b', 2]]);
console.log(JSON.stringify(map)); // 输出: {}
const set = new Set([1, 2, 3]);
console.log(JSON.stringify(set)); // 输出: {}

如果需要正确序列化 Map 或 Set，通常需要先将它们转换为普通对象或数组，可以使用 Array.from() 或展开运算符。

// 正确序列化 Map
const map = new Map([['a', 1], ['b', 2]]);
const mapToJson = JSON.stringify(Object.fromEntries(map));
console.log(mapToJson); // 输出: {"a":1,"b":2}
// 正确序列化 Set
const set = new Set([1, 2, 3]);
const setToJson = JSON.stringify(Array.from(set));
console.log(setToJson); // 输出: [1,2,3]

要将 JavaScript 数据转换为 JSON 字符串，JSON.stringify() 是你唯一需要的方法，记住以下几点：