JSON.stringify() 方法是將一個(gè)JavaScript值(對(duì)象或者數(shù)組)轉(zhuǎn)換為一個(gè) JSON字符串，如果指定了replacer是一個(gè)函數(shù)，則可以選擇性的替換值，或者如果指定了replacer是一個(gè)數(shù)組，可選擇性的僅包含數(shù)組指定的屬性。

語(yǔ)法

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

參數(shù)

value

將要序列化成 一個(gè)JSON 字符串的值。

replacer 可選

如果該參數(shù)是一個(gè)函數(shù)，則在序列化過程中，被序列化的值的每個(gè)屬性都會(huì)經(jīng)過該函數(shù)的轉(zhuǎn)換和處理；如果該參數(shù)是一個(gè)數(shù)組，則只有包含在這個(gè)數(shù)組中的屬性名才會(huì)被序列化到最終的 JSON 字符串中；如果該參數(shù)為null或者未提供，則對(duì)象所有的屬性都會(huì)被序列化；關(guān)于該參數(shù)更詳細(xì)的解釋和示例，請(qǐng)參考使用原生的 JSON 對(duì)象一文。

space 可選

指定縮進(jìn)用的空白字符串，用于美化輸出（pretty-print）；如果參數(shù)是個(gè)數(shù)字，它代表有多少的空格；上限為10。該值若小于1，則意味著沒有空格；如果該參數(shù)為字符串(字符串的前十個(gè)字母)，該字符串將被作為空格；如果該參數(shù)沒有提供（或者為null）將沒有空格。
返回值

一個(gè)表示給定值的JSON字符串。

描述
JSON.stringify()將值轉(zhuǎn)換為相應(yīng)的JSON格式：

• 轉(zhuǎn)換值如果有toJSON()方法，該方法定義什么值將被序列化。
• 非數(shù)組對(duì)象的屬性不能保證以特定的順序出現(xiàn)在序列化后的字符串中。
• 布爾值、數(shù)字、字符串的包裝對(duì)象在序列化過程中會(huì)自動(dòng)轉(zhuǎn)換成對(duì)應(yīng)的原始值。
• undefined、任意的函數(shù)以及 symbol 值，在序列化過程中會(huì)被忽略（出現(xiàn)在非數(shù)組對(duì)象的屬性值中時(shí)）或者被轉(zhuǎn)換成 null（出現(xiàn)在數(shù)組中時(shí)）。函數(shù)、undefined被單獨(dú)轉(zhuǎn)換時(shí)，會(huì)返回undefined，如JSON.stringify(function(){}) or JSON.stringify(undefined).
• 對(duì)包含循環(huán)引用的對(duì)象（對(duì)象之間相互引用，形成無(wú)限循環(huán)）執(zhí)行此方法，會(huì)拋出錯(cuò)誤。
• 所有以 symbol 為屬性鍵的屬性都會(huì)被完全忽略掉，即便 replacer 參數(shù)中強(qiáng)制指定包含了它們。
• Date日期調(diào)用了toJSON()將其轉(zhuǎn)換為了string字符串（同Date.toISOString()），因此會(huì)被當(dāng)做字符串處理。
• NaN和Infinity格式的數(shù)值及null都會(huì)被當(dāng)做null。
• 其他類型的對(duì)象，包括Map/Set/weakMap/weakSet，僅會(huì)序列化可枚舉的屬性。

實(shí)例

JSON.stringify({});            // '{}'JSON.stringify(true);           // 'true'JSON.stringify("foo");           // '"foo"'JSON.stringify([1, "false", false]);    // '[1,"false",false]'JSON.stringify({ x: 5 });         // '{"x":5}'JSON.stringify({x: 5, y: 6});       // "{"x":5,"y":6}"JSON.stringify([new Number(1), new String("false"), new Boolean(false)]); // '[1,"false",false]'JSON.stringify({x: undefined, y: Object, z: Symbol("")}); // '{}'JSON.stringify([undefined, Object, Symbol("")]);     // '[null,null,null]' JSON.stringify({[Symbol("foo")]: "foo"});         // '{}'JSON.stringify({[Symbol.for("foo")]: "foo"}, [Symbol.for("foo")]);// '{}'JSON.stringify(  {[Symbol.for("foo")]: "foo"},   function (k, v) {    if (typeof k === "symbol"){      return "a symbol";    }  });// undefined // 不可枚舉的屬性默認(rèn)會(huì)被忽略：JSON.stringify(   Object.create(    null,     {       x: { value: 'x', enumerable: false },       y: { value: 'y', enumerable: true }     }  ));// "{"y":"y"}"

replacer參數(shù)
replacer參數(shù)可以是一個(gè)函數(shù)或者一個(gè)數(shù)組。作為函數(shù)，它有兩個(gè)參數(shù)，鍵(key)值(value)都會(huì)被序列化。

• 如果返回一個(gè) Number, 轉(zhuǎn)換成相應(yīng)的字符串被添加入JSON字符串。
• 如果返回一個(gè) String, 該字符串作為屬性值被添加入JSON。
• 如果返回一個(gè) Boolean, "true" 或者 "false"被作為屬性值被添加入JSON字符串。
• 如果返回任何其他對(duì)象，該對(duì)象遞歸地序列化成JSON字符串，對(duì)每個(gè)屬性調(diào)用replacer方法。除非該對(duì)象是一個(gè)函數(shù)，這種情況將不會(huì)被序列化成JSON字符串。
• 如果返回undefined，該屬性值不會(huì)在JSON字符串中輸出。

注意: 不能用replacer方法，從數(shù)組中移除值(values)，如若返回undefined或者一個(gè)函數(shù)，將會(huì)被null取代。

例子(function)

function replacer(key, value) { if (typeof value === "string") {  return undefined; } return value;}var foo = {foundation: "Mozilla", model: "box", week: 45, transport: "car", month: 7};var jsonString = JSON.stringify(foo, replacer);

JSON序列化結(jié)果為 {"week":45,"month":7}.

例子(array)
如果replacer是一個(gè)數(shù)組，數(shù)組的值代表將被序列化成JSON字符串的屬性名。

JSON.stringify(foo, ['week', 'month']); 
// '{"week":45,"month":7}', 只保留“week”和“month”屬性值。

space 參數(shù)
space 參數(shù)用來控制結(jié)果字符串里面的間距。如果是一個(gè)數(shù)字, 則在字符串化時(shí)每一級(jí)別會(huì)比上一級(jí)別縮進(jìn)多這個(gè)數(shù)字值的空格（最多10個(gè)空格）；如果是一個(gè)字符串，則每一級(jí)別會(huì)比上一級(jí)別多縮進(jìn)用該字符串（或該字符串的前十個(gè)字符）。

JSON.stringify({ a: 2 }, null, " "); // '{/n "a": 2/n}'

使用制表符（/t）來縮進(jìn)：

JSON.stringify({ uno: 1, dos : 2 }, null, '/t')// '{      ///   "uno": 1, ///   "dos": 2 /// }'

toJSON 方法

如果一個(gè)被序列化的對(duì)象擁有 toJSON 方法，那么該 toJSON 方法就會(huì)覆蓋該對(duì)象默認(rèn)的序列化行為：不是那個(gè)對(duì)象被序列化，而是調(diào)用 toJSON 方法后的返回值會(huì)被序列化，例如：

var obj = { foo: 'foo', toJSON: function () {  return 'bar'; }};JSON.stringify(obj);   // '"bar"'JSON.stringify({x: obj}); // '{"x":"bar"}'

注意JSON不是javascript嚴(yán)格意義上的子集，在JSON中不需要省略兩條終線(Line separator和Paragraph separator)但在JavaScript中需要被省略。因此，如果JSON被用作JSONP時(shí)，下面方法可以使用：

function jsFriendlyJSONStringify (s) {  return JSON.stringify(s).    replace(//u2028/g, '//u2028').    replace(//u2029/g, '//u2029');}var s = {  a: String.fromCharCode(0x2028),  b: String.fromCharCode(0x2029)};try {  eval('(' + JSON.stringify(s) + ')');} catch (e) {  console.log(e); // "SyntaxError: unterminated string literal"}// No need for a catcheval('(' + jsFriendlyJSONStringify(s) + ')');// console.log in Firefox unescapes the Unicode if//  logged to console, so we use alertalert(jsFriendlyJSONStringify(s)); // {"a":"/u2028","b":"/u2029"}

使用 JSON.stringify 結(jié)合 localStorage 的例子
一些時(shí)候，你想存儲(chǔ)用戶創(chuàng)建的一個(gè)對(duì)象，并且，即使在瀏覽器被關(guān)閉后仍能恢復(fù)該對(duì)象。下面的例子是 JSON.stringify 適用于這種情形的一個(gè)樣板：

// 創(chuàng)建一個(gè)示例數(shù)據(jù)var session = {  'screens' : [],  'state' : true};session.screens.push({"name":"screenA", "width":450, "height":250});session.screens.push({"name":"screenB", "width":650, "height":350});session.screens.push({"name":"screenC", "width":750, "height":120});session.screens.push({"name":"screenD", "width":250, "height":60});session.screens.push({"name":"screenE", "width":390, "height":120});session.screens.push({"name":"screenF", "width":1240, "height":650});// 使用 JSON.stringify 轉(zhuǎn)換為 JSON 字符串// 然后使用 localStorage 保存在 session 名稱里localStorage.setItem('session', JSON.stringify(session));// 然后是如何轉(zhuǎn)換通過 JSON.stringify 生成的字符串，該字符串以 JSON 格式保存在 localStorage 里var restoredSession = JSON.parse(localStorage.getItem('session'));// 現(xiàn)在 restoredSession 包含了保存在 localStorage 里的對(duì)象console.log(restoredSession);

規(guī)范

規(guī)范名稱及鏈接 規(guī)范狀態(tài)
ECMAScript 5.1 (ECMA-262) JSON.stringify

ECMAScript 2015 (6th Edition, ECMA-262)JSON.stringify

瀏覽器兼容性

這篇文章就介紹到這了，想更多的了解JSON stringify的知識(shí)可以查看以下相關(guān)文章。