jsJSON.stringify()函数的使⽤【转】
JSON.stringify()⽅法将⼀个 JavaScript 值(对象或者数组)转换为⼀个 JSON 字符串,如果指定了 replacer 是⼀个函数,则可以选择性地替换值,或者如果指定了 replacer 是⼀个数组,则可选择性地仅包含数组指定的属性。
语法
JSON.stringify(value[, replacer [, space]])
参数
value
将要序列化成⼀个 JSON 字符串的值。
replacer可选
如果该参数是⼀个函数,则在序列化过程中,被序列化的值的每个属性都会经过该函数的转换和处理;如果该参数是⼀个数组,则只有包含在这个数组中的属性名才会被序列化到最终的 JSON 字符串中;如
果该参数为 null 或者未提供,则对象所有的属性都会被序列化;关于该参数更详细的解释和⽰例,请参考⼀⽂。
space可选
指定缩进⽤的空⽩字符串,⽤于美化输出(pretty-print);如果参数是个数字,它代表有多少的空格;上限为10。该值若⼩于1,则意味着没有空格;如果该参数为字符串(当字符串长度超过10个字母,取其前10个字母),该字符串将被作为空格;如果该参数没有提供(或者为null),将没有空格。
返回值
⼀个表⽰给定值的JSON字符串。
描述
JSON.stringify() 将值转换为相应的JSON格式:
转换值如果有 toJSON() ⽅法,该⽅法定义什么值将被序列化。
⾮数组对象的属性不能保证以特定的顺序出现在序列化后的字符串中。
布尔值、数字、字符串的包装对象在序列化过程中会⾃动转换成对应的原始值。
undefined、任意的函数以及 symbol 值,在序列化过程中会被忽略(出现在⾮数组对象的属性值中时)或者被转换成null(出现在数组中时)。函数、undefined 被单独转换时,会返回 undefined,如JSON.stringify(function(){}) or JSON.stringify(undefined).
对包含循环引⽤的对象(对象之间相互引⽤,形成⽆限循环)执⾏此⽅法,会抛出错误。
所有以 symbol 为属性键的属性都会被完全忽略掉,即便replacer参数中强制指定包含了它们。
Date ⽇期调⽤了 toJSON() 将其转换为了 string 字符串(同ISOString()),因此会被当做字符串处理。
NaN 和 Infinity 格式的数值及 null 都会被当做 null。
其他类型的对象,包括 Map/Set/WeakMap/WeakSet,仅会序列化可枚举的属性。
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
// 不可枚举的属性默认会被忽略:
JSON.stringify(
null,
{
x: { value: 'x', enumerable: false },
y: { value: 'y', enumerable: true }
}
js获取json的key和value)
)
;
// "{"y":"y"}"
replacer参数
replacer 参数可以是⼀个函数或者⼀个数组。作为函数,它有两个参数,键(key)和值(value),它们都会被序列化。
在开始时,replacer 函数会被传⼊⼀个空字符串作为key值,代表着要被 stringify 的这个对象。随后每个对象或数组上的属性会被依次传⼊。函数应当返回JSON字符串中的value, 如下所⽰:
如果返回⼀个, 转换成相应的字符串作为属性值被添加⼊ JSON 字符串。
如果返回⼀个, 该字符串作为属性值被添加⼊ JSON 字符串。
如果返回⼀个, "true" 或者 "false" 作为属性值被添加⼊ JSON 字符串。
如果返回任何其他对象,该对象递归地序列化成 JSON 字符串,对每个属性调⽤ replacer ⽅法。除⾮该对象是⼀个函数,这种情况将不会被序列化成 JSON 字符串。
如果返回 undefined,该属性值不会在 JSON 字符串中输出。
注意: 不能⽤ replacer ⽅法,从数组中移除值(values),如若返回 undefined 或者⼀个函数,将会被 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序列化结果为 {"week":45,"month":7}.
例⼦(array)
如果 replacer 是⼀个数组,数组的值代表将被序列化成 JSON 字符串的属性名。
JSON.stringify(foo, ['week', 'month']);
// '{"week":45,"month":7}', 只保留 “week” 和 “month” 属性值。
space参数
space参数⽤来控制结果字符串⾥⾯的间距。如果是⼀个数字, 则在字符串化时每⼀级别会⽐上⼀级别缩进多这个数字值的空格(最多10个
空格);如果是⼀个字符串,则每⼀级别会⽐上⼀级别多缩进该字符串(或该字符串的前10个字符)。
JSON.stringify({ a: 2 }, null, " ");  // '{\n "a": 2\n}'
使⽤制表符(\t)来缩进:
JSON.stringify({ uno: 1, dos : 2 }, null, '\t')
// '{            \
//    "uno": 1, \
//    "dos": 2  \
// }'
toJSON ⽅法
如果⼀个被序列化的对象拥有toJSON⽅法,那么该toJSON⽅法就会覆盖该对象默认的序列化⾏为:不是该对象被序列化,⽽是调
⽤toJSON⽅法后的返回值会被序列化,例如:
var obj = {
foo: 'foo',
toJSON: function () {
return 'bar';
}
};
JSON.stringify(obj);      // '"bar"'
JSON.stringify({x: obj}); // '{"x":"bar"}'
JSON.stringify⽤作 JavaScript
注意 JSON 不是 JavaScript 严格意义上的⼦集,在 JSON 中不需要省略两条终线(Line separator 和 Paragraph separator),但在JavaScript 中需要被省略。因此,如果 JSON 被⽤作 JSONP 时,下⾯⽅法可以使⽤:
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 结合 localStorage 的例⼦
⼀些时候,你想存储⽤户创建的⼀个对象,并且,即使在浏览器被关闭后仍能恢复该对象。下⾯的例⼦是JSON.stringify适⽤于这种情形的⼀个样板:
// 创建⼀个⽰例数据
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 转换为 JSON 字符串
// 然后使⽤ localStorage 保存在 session 名称⾥
localStorage.setItem('session', JSON.stringify(session));
// 然后是如何转换通过 JSON.stringify ⽣成的字符串,该字符串以 JSON 格式保存在 localStorage ⾥var restoredSession = JSON.Item('session'));
// 现在 restoredSession 包含了保存在 localStorage ⾥的对象
console.log(restoredSession);

版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。