JavaScript JSON stringify()方法

简介

JavaScript中的JSON stringify()方法可以将 JavaScript 对象转换为 JSON字符串。

语法

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

参数

• value - 必填。要转换的JavaScript对象。
• replacer - 可选。一种转换函数，用来控制JSON.stringify()在哪些属性上执行转换操作。可以是一个数组或一个函数。
• space - 可选。一种对输出进行格式化的选项。可以是一个数字或一个字符串（用于缩进），也可以是null（表示输出无格式）。

返回值

JSON.stringify()方法返回一个JSON字符串。

示例

示例1

const obj = { name: 'Alice', age: 25 };
const jsonString = JSON.stringify(obj);
console.log(jsonString);
// 输出: {"name":"Alice","age":25}

示例2

const obj = { name: 'Alice', age: 25, toJSON: function() { return this.name; } };
const jsonString = JSON.stringify(obj);
console.log(jsonString);
// 输出: "Alice"

示例3

const obj = { name: 'Alice', age: 25 };
const jsonString = JSON.stringify(obj, ['name']);
console.log(jsonString);
// 输出: {"name":"Alice"}

示例4

const obj = { name: 'Alice', age: 25 };
const jsonString = JSON.stringify(obj, null, 4);
console.log(jsonString);
// 输出:
// {
//     "name": "Alice",
//     "age": 25
// }

注意事项

• Date对象在经过JSON.stringify()方法转换后会变成ISO格式的时间字符串。
• undefined、函数和symbol类型的属性会在JSON.stringify()方法中被忽略。
• 由于JSON字符串不能包含回车符和换行符，JSON.stringify()方法会将回车符和换行符转移为\n。
• 遇到循环引用会抛出错误。
• JSON.stringify()方法只能序列化对象的可枚举属性。

参考文献

• MDN web docs: JSON.stringify()