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()` 方法,来自定义值的转换过程。
免责声明:
① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。
② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341