JavaScript JSON.stringify() JavaScript JSON
JSON.stringify() 方法用于将 JavaScript 值转换为 JSON 字符串。
语法 JSON.stringify(value[, replacer[, space]])
参数说明:
value:
必需, 要转换的 JavaScript 值(通常为对象或数组)。
replacer:
可选。用于转换结果的函数或数组。
如果 replacer 为函数,则 JSON.stringify 将调用该函数,并传入每个成员的键和值。使用返回值而不是原始值。如果此函数返回 undefined,则排除成员。根对象的键是一个空字符串:""。
如果 replacer 是一个数组,则仅转换该数组中具有键值的成员。成员的转换顺序与键在数组中的顺序一样。
space:
可选,文本添加缩进、空格和换行符,如果 space 是一个数字,则返回值文本在每个级别缩进指定数目的空格,如果 space 大于 10,则文本缩进 10 个空格。space 也可以使用非数字,如:\t。
返回值: 返回包含 JSON 文本的字符串。
实例 实例 var str = { " name " : " 菜鸟教程 " , " site " : " http://www.runoob.com " }
str_pretty1 = JSON . stringify ( str )
document . write ( " 只有一个参数情况: " ) ;
document . write ( " <br> " ) ;
document . write ( " <pre> " + str_pretty1 + " </pre> " ) ;
document . write ( " <br> " ) ;
str_pretty2 = JSON . stringify ( str , null , 4 )
document . write ( " 使用参数情况: " ) ;
document . write ( " <br> " ) ;
document . write ( " <pre> " + str_pretty2 + " </pre> " ) ; 尝试一下 » JavaScript JSON
JSON.stringify()
方法是将一个JavaScript值(对象或者数组)转换为一个 JSON字符串,如果指定了replacer是一个函数,则可以选择性的替换值,或者如果指定了replacer是一个数组,可选择性的仅包含数组指定的属性。
JSON.stringify(value [, replacer [, space ]])
value
将要序列化成 一个JSON 字符串的值。
replacer
可选
如果该参数是一个函数,则在序列化过程中,被序列化的值的每个属性都会经过该函数的转换和处理;如果该参数是一个数组,则只有包含在这个数组中的属性名才会被序列化到最终的 JSON 字符串中;如果该参数为null或者未提供,则对象所有的属性都会被序列化;关于该参数更详细的解释和示例,请参考使用原生的 JSON 对象 一文。
space
可选
指定缩进用的空白字符串,用于美化输出(pretty-print);如果参数是个数字,它代表有多少的空格;上限为10。该值若小于1,则意味着没有空格;如果该参数为字符串(字符串的前十个字母),该字符串将被作为空格;如果该参数没有提供(或者为null)将没有空格。
返回值 节 一个表示给定值的JSON字符串。
JSON.stringify()将值转换为相应的JSON格式:
转换值如果有toJSON()方法,该方法定义什么值将被序列化。
非数组对象的属性不能保证以特定的顺序出现在序列化后的字符串中。
布尔值、数字、字符串的包装对象在序列化过程中会自动转换成对应的原始值。
undefined、
任意的函数以及 symbol 值,在序列化过程中会被忽略(出现在非数组对象的属性值中时)或者被转换成 null
(出现在数组中时)。函数、undefined被单独转换时,会返回undefined,如JSON.stringify(function(){})
or JSON.stringify(undefined).
对包含循环引用的对象(对象之间相互引用,形成无限循环)执行此方法,会抛出错误。
所有以 symbol 为属性键的属性都会被完全忽略掉,即便 replacer
参数中强制指定包含了它们。
Date日期调用了toJSON()将其转换为了string字符串(同Date.toISOString()),因此会被当做字符串处理。
NaN和Infinity格式的数值及null都会被当做null。
其他类型的对象,包括Map/Set/weakMap/weakSet,仅会序列化可枚举的属性。
JSON . stringify ( { } ) ;
JSON . stringify ( true ) ;
JSON . stringify ( "foo" ) ;
JSON . stringify ( [ 1 , "false" , false ] ) ;
JSON . stringify ( { x: 5 } ) ;
JSON . stringify ( { x: 5 , y: 6 } ) ;
JSON . stringify ( [ new Number ( 1 ) , new String ( "false" ) , new Boolean ( false ) ] ) ;
JSON . stringify ( { x: undefined , y: Object, z: Symbol ( "" ) } ) ;
JSON . stringify ( [ undefined , Object, Symbol ( "" ) ] ) ;
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" ;
}
}
) ;
JSON . stringify (
Object. create (
null ,
{
x: { value: 'x' , enumerable: false } ,
y: { value: 'y' , enumerable: true }
}
)
) ;
replacer参数
节 replacer参数可以是一个函数或者一个数组。作为函数,它有两个参数,键(key)值(value)都会被序列化。
如果返回一个 Number
, 转换成相应的字符串被添加入JSON字符串。
如果返回一个 String
, 该字符串作为属性值被添加入JSON。
如果返回一个 Boolean
, "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个空格);如果是一个字符串,则每一级别会比上一级别多缩进用该字符串(或该字符串的前十个字符)。
JSON . stringify ( { a: 2 } , null , " " ) ;
使用制表符(\t)来缩进:
JSON . stringify ( { uno: 1 , dos : 2 } , null , '\t' )
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 } ) ;
localStorage. setItem ( 'session' , JSON . stringify ( session) ) ;
var restoredSession = JSON . parse ( localStorage. getItem ( 'session' ) ) ;
console. log ( restoredSession) ;
浏览器兼容性节 We're converting our compatibility data into a machine-readable JSON format . This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help! Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari Basic support (Yes) 3.5 (1.9.1)8.0 10.5 4.0
相关链接节