JSON.stringify() 九大特性
一、对于 undefined、任意的函数以及 symbol 三个特殊的值分别作为对象属性的值、数组元素、单独的值时的不同返回结果。
-
undefined、任意的函数以及 symbol 作为对象属性值时 JSON.stringify() 跳过(忽略)对它们进行序列化
const data = { a: "aaa", b: undefined, c: Symbol("dd"), fn: function() { return true; } }; JSON.stringify(data); // 输出:? // "{"a":"aaa"}"
-
undefined、任意的函数以及 symbol 作为数组元素值时,JSON.stringify() 将会将它们序列化为 null
JSON.stringify(["aaa", undefined, function aa() { return true }, Symbol('dd')]) // 输出:? // "["aaa",null,null,null]"
-
undefined、任意的函数以及 symbol 被 JSON.stringify() 作为单独的值进行序列化时都会返回 undefined
JSON.stringify(function a (){console.log('a')}) // undefined JSON.stringify(undefined) // undefined JSON.stringify(Symbol('dd')) // undefined
二、非数组对象的属性不能保证以特定的顺序出现在序列化后的字符串中。
const data = { a: "aaa", b: undefined, c: Symbol("dd"), fn: function() { return true; }, d: "ddd" }; JSON.stringify(data); // 输出:? // "{"a":"aaa","d":"ddd"}" JSON.stringify(["aaa", undefined, function aa() { return true }, Symbol('dd'),"eee"]) // 输出:? // "["aaa",null,null,null,"eee"]"
三、转换值如果有 toJSON() 函数,该函数返回什么值,序列化结果就是什么值,并且忽略其他属性的值。
JSON.stringify({ say: "hello JSON.stringify", toJSON: function() { return "today i learn"; } }) // "today i learn"
四、JSON.stringify() 将会正常序列化 Date 的值。
JSON.stringify({ now: new Date() });
// "{"now":"2019-12-08T07:42:11.973Z"}"
五、NaN 和 Infinity 格式的数值及 null 都会被当做 null。
JSON.stringify(NaN) // "null" JSON.stringify(null) // "null" JSON.stringify(Infinity) // "null"
六、布尔值、数字、字符串的包装对象在序列化过程中会自动转换成对应的原始值。
JSON.stringify([new Number(1), new String("false"), new Boolean(false)]); // "[1,"false",false]"
七、其他类型的对象,包括 Map/Set/WeakMap/WeakSet,仅会序列化可枚举的属性。
// 不可枚举的属性默认会被忽略: JSON.stringify( Object.create( null, { x: { value: 'json', enumerable: false }, y: { value: 'stringify', enumerable: true } } ) ); // "{"y":"stringify"}"
八、对包含循环引用的对象(对象之间相互引用,形成无限循环)执行此方法,会抛出错误。
// 对包含循环引用的对象(对象之间相互引用,形成无限循环)执行此方法,会抛出错误。 const obj = { name: "loopObj" }; const loopObj = { obj }; // 对象之间形成循环引用,形成闭环 obj.loopObj = loopObj; function deepClone(obj) { return JSON.parse(JSON.stringify(obj)); } deepClone(obj) /** VM44:9 Uncaught TypeError: Converting circular structure to JSON --> starting at object with constructor 'Object' | property 'loopObj' -> object with constructor 'Object' --- property 'obj' closes the circle at JSON.stringify (<anonymous>) at deepClone (<anonymous>:9:26) at <anonymous>:11:13 */
九、所有以 symbol 为属性键的属性都会被完全忽略掉,即便 replacer 参数中强制指定包含了它们。
JSON.stringify({ [Symbol.for("json")]: "stringify" }, function(k, v) {
if (typeof k === "symbol") {
return v;
}
})
// undefined
JSON.stringify() 第二个参数和第三个参数
强大的第二个参数:
-
作为函数时,它有两个参数,键(key)和值(value),函数类似就是数组方法 map、filter 等方法的回调函数,对每一个属性值都会执行一次该函数(期间我们还简单实现过一个 map 函数)。
-
如果 replacer 是一个数组,数组的值代表将被序列化成 JSON 字符串的属性名。
华丽的第三个参数:
-
如果是一个数字, 则在字符串化时每一级别会比上一级别缩进多这个数字值的空格(最多10个空格);
-
如果是一个字符串,则每一级别会比上一级别多缩进该字符串(或该字符串的前10个字符)。
浙公网安备 33010602011771号