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

語法

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或者未提供，則對象所有的屬性都會(huì)被序列化；關(guān)于該參數(shù)更詳細(xì)的解釋和示例，請參考使用原生的 JSON 對象一文。
space 可選
指定縮進(jìn)用的空白字符串，用于美化輸出（pretty-print）；如果參數(shù)是個(gè)數(shù)字，它代表有多少的空格；上限為10。該值若小于1，則意味著沒有空格；如果該參數(shù)為字符串(字符串的前十個(gè)字母)，該字符串將被作為空格；如果該參數(shù)沒有提供（或者為null）將沒有空格。
返回值

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

描述

關(guān)于序列化，有下面五點(diǎn)注意事項(xiàng)：

非數(shù)組對象的屬性不能保證以特定的順序出現(xiàn)在序列化后的字符串中。
布爾值、數(shù)字、字符串的包裝對象在序列化過程中會(huì)自動(dòng)轉(zhuǎn)換成對應(yīng)的原始值。
undefined、任意的函數(shù)以及 symbol 值，在序列化過程中會(huì)被忽略（出現(xiàn)在非數(shù)組對象的屬性值中時(shí)）或者被轉(zhuǎn)換成 null（出現(xiàn)在數(shù)組中時(shí)）。
對包含循環(huán)引用的對象（對象之間相互引用，形成無限循環(huán)）執(zhí)行此方法，會(huì)拋出錯(cuò)誤。
所有以 symbol 為屬性鍵的屬性都會(huì)被完全忽略掉，即便 replacer 參數(shù)中強(qiáng)制指定包含了它們。
不可枚舉的屬性會(huì)被忽略
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字符串。
如果返回任何其他對象，該對象遞歸地序列化成JSON字符串，對每個(gè)屬性調(diào)用replacer方法。除非該對象是一個(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í)每一級別會(huì)比上一級別縮進(jìn)多這個(gè)數(shù)字值的空格（最多10個(gè)空格）；如果是一個(gè)字符串，則每一級別會(huì)比上一級別多縮進(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è)被序列化的對象擁有 toJSON 方法，那么該 toJSON 方法就會(huì)覆蓋該對象默認(rèn)的序列化行為：不是那個(gè)對象被序列化，而是調(diào)用 toJSON 方法后的返回值會(huì)被序列化，例如：

var obj = {
foo: ‘foo’,
toJSON: function () {
return ‘bar’;
}
};
JSON.stringify(obj); // ‘“bar”’
JSON.stringify({x: obj}); // ‘{“x”:”bar”}’
JSON.stringify用作 JavaScript

注意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 catch
eval(‘(’ + jsFriendlyJSONStringify(s) + ‘)’);

// console.log in Firefox unescapes the Unicode if
// logged to console, so we use alert
alert(jsFriendlyJSONStringify(s)); // {“a”:”\u2028”,”b”:”\u2029”}
使用 JSON.stringify 結(jié)合 localStorage 的例子

一些時(shí)候，你想存儲(chǔ)用戶創(chuàng)建的一個(gè)對象，并且，即使在瀏覽器被關(guān)閉后仍能恢復(fù)該對象。下面的例子是 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 里的對象
console.log(restoredSession);

創(chuàng)作挑戰(zhàn)賽新人創(chuàng)作獎(jiǎng)勵(lì)來咯，堅(jiān)持創(chuàng)作打卡瓜分現(xiàn)金大獎(jiǎng)

總結(jié)

以上是生活随笔為你收集整理的JSON.stringify() 方法的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。