前言

JSON是一種輕量級數(shù)據(jù)格式，可以方便地表示復雜數(shù)據(jù)結(jié)構(gòu)。JSON對象有兩個方法：stringify()和parse()。在簡單的情況下，這兩個方法分別可以將JavaScript序列化為JSON字符串，以及將JSON解析為原生JavaScript值。

本文著重介紹JSON.stringify()的使用方法和注意事項。

一、使用方法

1、基本用法

JSON.stringify()可以把一個JavaScript對象序列化為一個JSON字符串。

1. let json1 = { 
2.   title: "Json.stringify", 
3.   author: [ 
4.     "浪里行舟" 
5.   ], 
6.   year: 2021 
7. }; 
8. let jsonText = JSON.stringify(json1); 

默認情況下，JSON.stringify()會輸出不包含空格或縮進的JSON字符串，因此jsonText的值是這樣的：

1. "{"title":"Json.stringify","author":["浪里行舟"],"year":2021}" 

在序列化JavaScript對象時，所有函數(shù)和原型成員都會有意地在結(jié)果中省略。此外，值為undefined的任何屬性也會被跳過。最終得到的就是所有實例屬性均為有效JSON數(shù)據(jù)類型的表示。

在JSON.stringify()方法一共能接受3個參數(shù)，其中兩個可選的參數(shù)(分別是第二、第三個參數(shù))。這兩個可選參數(shù)可以用于指定其他序列化JavaScript對象的方式。第二個參數(shù)是過濾器，可以是數(shù)組或函數(shù);第三個參數(shù)是用于縮進結(jié)果JSON字符串的選項。單獨或組合使用這些參數(shù)可以更好地控制JSON序列化。

2、第二個參數(shù)--過濾器

如果第二個參數(shù)是一個數(shù)組，那么JSON.stringify()返回的結(jié)果只會包含該數(shù)組中列出的對象屬性。比如下面的例子：

1. let json1 = { 
2.   title: "Json.stringify", 
3.   author: [ 
4.     "浪里行舟" 
5.   ], 
6.   year: 2021, 
7.   like: 'frontend', 
8.   weixin: 'frontJS' 
9. }; 
10. let jsonText = JSON.stringify(json1, ['weixin']); 

在這個例子中，JSON.stringify()方法的第二個參數(shù)是一個包含一個字符串的數(shù)組："weixin"。它對應著要序列化的對象中的屬性，因此結(jié)果JSON字符串中只會包含這個屬性：

1. "{"weixin":"frontJS"}" 

如果第二個參數(shù)是一個函數(shù)，則行為又有不同。提供的函數(shù)接收兩個參數(shù)：屬性名(key)和屬性值(value)。可以根據(jù)這個key決定要對相應屬性執(zhí)行什么操作。這個key始終是字符串，只是在值不屬于某個鍵/值對時會是空字符串。

1. const students = [ 
2.   { 
3.     name: 'james', 
4.     score: 100, 
5.   }, { 
6.     name: 'jordon', 
7.     score: 60, 
8.   }, { 
9.     name: 'kobe', 
10.     score: 90, 
11.   } 
12. ]; 
13.  
14. function replacer (key, value) { 
15.   if (key === 'score') { 
16.     if (value === 100) { 
17.       return 'S'; 
18.     } else if (value >= 90) { 
19.       return 'A'; 
20.     } else if (value >= 70) { 
21.       return 'B'; 
22.     } else if (value >= 50) { 
23.       return 'C'; 
24.     } else { 
25.       return 'E'; 
26.     } 
27.   } 
28.   return value; 
29. } 
30. console.log(JSON.stringify(students, replacer, 4)) 

上面的代碼，我們通過replacer將成績從百分制替換為成績等級。

值得注意的是，如果stringify的第二個參數(shù)為函數(shù)那么它的返回值如果是undefined，那么對應的屬性不會被序列化，如果返回其他的值，那么用返回的值替代原來的值進行序列化。

3、第三個參數(shù)--字符串縮進

JSON.stringify()方法的第三個參數(shù)控制縮進和空格。在這個參數(shù)是數(shù)值時，表示每一級縮進的空格數(shù)。例如，每級縮進4個空格，可以這樣：

1. let json1 = { 
2.   title: "Json.stringify", 
3.   author: [ 
4.     "浪里行舟" 
5.   ], 
6.   year: 2021 
7. }; 
8. let jsonText = JSON.stringify(json1, null, 4); 

這樣得到的jsonText格式如下：

1. { 
2.     "title": "Json.stringify", 
3.     "author": [ 
4.         "浪里行舟" 
5.     ], 
6.     "year": 2021 
7. } 

JSON.stringify()在處理數(shù)據(jù)的時候同時考慮了數(shù)據(jù)轉(zhuǎn)換和方便閱讀，只不過，方便閱讀這一點，常常被人忽略。

4、toJSON()方法--自定義JSON序列化

有時候，對象需要在JSON.stringify()之上自定義JSON序列化。此時，可以在要序列化的對象中添加toJSON()方法，序列化時會基于這個方法返回適當?shù)腏SON表示。

下面的對象為自定義序列化而添加了一個toJSON()方法：

1. let json1 = { 
2.   title: "Json.stringify", 
3.   author: [ 
4.     "浪里行舟" 
5.   ], 
6.   year: 2021, 
7.   like: 'frontend', 
8.   weixin: 'frontJS', 
9.   toJSON: function () { 
10.     return this.author 
11.   } 
12. }; 
13. console.log(JSON.stringify(json1)); // ["浪里行舟"] 

注意，箭頭函數(shù)不能用來定義toJSON()方法。主要原因是箭頭函數(shù)的詞法作用域是全局作用域，在這種情況下不合適。

二、使用場景

1、判斷數(shù)組是否包含某對象，或者判斷對象是否相等。

1. //判斷數(shù)組是否包含某對象 
2. let data = [ 
3.     {name:'浪里行舟'}, 
4.     {name:'前端工匠'}, 
5.     {name:'前端開發(fā)'}, 
6.     ], 
7.     val = {name:'浪里行舟'}; 
8. console.log(JSON.stringify(data).indexOf(JSON.stringify(val)) !== -1);//true 

我們還可以使用JSON.stringify()方法,來判斷兩個對象是否相等。

1. // 判斷對象是否相等 
2. let obj1 = { 
3.     a: 1, 
4.     b: 2 
5.   } 
6.   let obj2 = { 
7.     a: 1, 
8.     b: 2, 
9.   } 
10. console.log(JSON.stringify(obj1) === JSON.stringify(obj2)) // true 

不過這種方式存在著較大的局限性，對象如果調(diào)整了鍵的順序，就會判斷出錯!

1. // 調(diào)整對象鍵的位置后 
2. let obj1 = { 
3.     a: 1, 
4.     b: 2 
5.   } 
6.   let obj2 = { 
7.     b: 2, 
8.     a: 1, 
9.   } 
10. console.log(JSON.stringify(obj1) === JSON.stringify(obj2)) // false 

2、使用localStorage/sessionStorage時

localStorage/sessionStorage默認只能存儲字符串，而實際開發(fā)中，我們往往需要存儲對象類型，那么此時我們需要在存儲時利用json.stringify()將對象轉(zhuǎn)為字符串，在取本地緩存時，使用json.parse()轉(zhuǎn)回對象即可。

1. // 存數(shù)據(jù) 
2. function setLocalStorage(key,val) { 
3.     window.localStorage.setItem(key, JSON.stringify(val)); 
4. }; 
5. // 取數(shù)據(jù) 
6. function getLocalStorage(key) { 
7.     let val = JSON.parse(window.localStorage.getItem(key)); 
8.     return val; 
9. }; 
10. // 測試 
11. setLocalStorage('Test',['前端工匠','浪里行舟']); 
12. console.log(getLocalStorage('Test')); 

localStorage

3、實現(xiàn)對象深拷貝

開發(fā)中，有時候怕影響原數(shù)據(jù)，我們常深拷貝出一份數(shù)據(jù)做任意操作，使用JSON.stringify()與JSON.parse()來實現(xiàn)深拷貝是很不錯的選擇。

1. let arr1 = [1, 3, { 
2.     username: ' kobe' 
3. }]; 
4. let arr2 = JSON.parse(JSON.stringify(arr1)); 
5. arr2[2].username = 'duncan';  
6. console.log(arr1, arr2) 

image.png

這是利用JSON.stringify將對象轉(zhuǎn)成JSON字符串，再用JSON.parse把字符串解析成對象，一去一來，新的對象產(chǎn)生了，新對象會開辟新的棧，實現(xiàn)深拷貝。

這種方法雖然可以實現(xiàn)數(shù)組或?qū)ο笊羁截?但不能處理函數(shù)和正則，因為這兩者基于JSON.stringify和JSON.parse處理后，得到的正則就不再是正則(變?yōu)榭諏ο?，得到的函數(shù)就不再是函數(shù)(變?yōu)閚ull)了。

1. let arr1 = [1, 3, function () { }, { 
2.   username: ' kobe' 
3. }]; 
4. let arr2 = JSON.parse(JSON.stringify(arr1)); 
5. arr2[3].username = 'duncan'; 
6. console.log(arr1, arr2) 

三、使用注意事項

JSON.stringify()雖然功能很強大，但是有些屬性無法被stringify，所以在開發(fā)中需注意以下幾種情況，以免產(chǎn)生一些始料未及的BUG。

1、被轉(zhuǎn)換值中有 NaN 和 Infinitylet my

1. let myObj = { 
2.   name: "浪里行舟", 
3.   age: Infinity, 
4.   money: NaN, 
5. }; 
6. console.log(JSON.stringify(myObj)); 
7. // {"name":"浪里行舟","age":null,"money":null} 
8.  
9. JSON.stringify([NaN, Infinity]) 
10. // [null,null] 

2、被轉(zhuǎn)換值中有 undefined、任意的函數(shù)以及 symbol 值

分為兩種情況：

數(shù)組,undefined、任意的函數(shù)以及symbol值在序列化的過程中會被轉(zhuǎn)換成 null

1. JSON.stringify([undefined, function () { }, Symbol("")]); 
2. // '[null,null,null]' 

非數(shù)組,undefined、任意的函數(shù)以及symbol值在序列化的過程中會被忽略

1. JSON.stringify({ x: undefined, y: function () { }, z: Symbol("") }); 
2. // '{}' 

3、循環(huán)引用

如果一個對象的屬性值通過某種間接的方式指回該對象本身，那么就是一個循環(huán)引用。比如：

1. let bar = { 
2.   a: { 
3.     c: foo 
4.   } 
5. }; 
6. let foo = { 
7.   b: bar 
8. }; 
9.  
10. JSON.stringify(foo) 

這種情況下，序列化會報錯的：

1. // 錯誤信息 
2. Uncaught ReferenceError: foo is not defined 
3.     at <anonymous>:3:8 

4、含有不可枚舉的屬性值時

不可枚舉的屬性默認會被忽略：

1. let personObj = Object.create(null, { 
2.   name: { value: "浪里行舟", enumerable: false }, 
3.   year: { value: "2021", enumerable: true }, 
4. }) 
5.  
6. console.log(JSON.stringify(personObj)) // {"year":"2021"} 

四、總結(jié)

JSON.stringify()用于將JavaScript對象序列化為JSON字符串，這方法有一些選項可以用來改變默認的行為，以實現(xiàn)過濾或修改流程。不過也應該注意有些屬性是無法被 stringify，所以開發(fā)時候應該避開這些坑!

參考資料

• JavaScript高級程序設計(第4版)
• 慎用JSON.stringify
• 你會用JS格式化JSON嗎?
• json.stringify()的妙用
• 你所不知道的JSON.stringify

原文地址：https://mp.weixin.qq.com/s/X4eMPpwNMyA23DpseETj7w