新闻资讯

质量为本、客户为根、勇于拼搏、务实创新

< 返回新闻资讯列表

json.stringify()详解

发布时间:2023-09-13 08:06:08

json.stringify()详解

`JSON.stringify()` 是一个 JSON 对象的方法,用于将一个 JavaScript 值转换为一个 JSON 字符串。
### 语法
```javascript
JSON.stringify(value[, replacer[, space]])
```
### 参数
- `value`:必须,要转换成 JSON 字符串的值。
- `replacer`:可选,用于转换结果的函数或数组。如果是函数,则在转换进程中,被转换的值会传递给这个函数,并终究返回转换结果。如果是数组,则只有包括在这个数组中的属性名才会被转换到 JSON 字符串中。
- `space`:可选,用于美化输出的字符串。可以是一个字符串,用于指定缩进的空白字符,也能够是一个正整数,表示缩进的空格数。
### 返回值
一个表示给定值的 JSON 字符串。
### 示例
```javascript
// 将一个 JavaScript 对象转换为 JSON 字符串
const obj = { name: "John", age: 30, city: "New York" };
const jsonStr = JSON.stringify(obj);
console.log(jsonStr);
// 输出:{"name":"John","age":30,"city":"New York"}
// 将一个数组转换为 JSON 字符串
const arr = [1, 2, 3, 4, 5];
const jsonArr = JSON.stringify(arr);
console.log(jsonArr);
// 输出:[1,2,3,4,5]
// 使用 replacer 函数过滤转换的属性
const obj2 = { name: "John", age: 30, city: "New York" };
const jsonStr2 = JSON.stringify(obj2, ["name", "age"]);
console.log(jsonStr2);
// 输出:{"name":"John","age":30}
// 使用 replacer 函数修改转换的属性
const obj3 = { name: "John", age: 30, city: "New York" };
const jsonStr3 = JSON.stringify(obj3, (key, value) => {
if (key === "name") {
return value.toUpperCase();
}
return value;
});
console.log(jsonStr3);
// 输出:{"name":"JOHN","age":30,"city":"New York"}
// 使用 space 参数美化输出
const obj4 = { name: "John", age: 30, city: "New York" };
const jsonStr4 = JSON.stringify(obj4, null, 2);
console.log(jsonStr4);
// 输出:
// {
// "name": "John",
// "age": 30,
// "city": "New York"
// }
```
### 注意事项
- 转换进程中,`undefined`、`function` 和 `symbol` 类型的属性会被自动疏忽。
- 如果一个属性值为 `NaN`、`Infinity` 或 `-Infinity`,则会被转换成 `null`。
- 如果 `replacer` 是一个数组,但数组中的元素不是字符串,则会被疏忽。
- `JSON.stringify()` 方法不会转换对象的原型链上的属性。
- 如果对象中存在循环援用,则会抛出 `TypeError`。
- 在转换进程中,对非法的 JSON 值(例如 `Infinity`、`-Infinity` 和 `NaN`),会将其转换成 `null`。
- 自定义对象的属性值如果含有函数(方法),则在转换为 JSON 字符串时会被疏忽。
- 对象的属性名如果为非字符串类型,会被自动转换为字符串。
- 转换一个 JavaScript 值时,可以通过在该值上添加 `toJSON()` 方法,来自定义值的转换进程。