js JSON.stringify()基礎(chǔ)詳解
JSON.stringify() 方法是將一個JavaScript值(對象或者數(shù)組)轉(zhuǎn)換為一個 JSON字符串,如果指定了replacer是一個函數(shù),則可以選擇性的替換值,或者如果指定了replacer是一個數(shù)組,可選擇性的僅包含數(shù)組指定的屬性。
語法
JSON.stringify(value[, replacer [, space]])
參數(shù)
value
將要序列化成 一個JSON 字符串的值。
replacer 可選
如果該參數(shù)是一個函數(shù),則在序列化過程中,被序列化的值的每個屬性都會經(jīng)過該函數(shù)的轉(zhuǎn)換和處理;如果該參數(shù)是一個數(shù)組,則只有包含在這個數(shù)組中的屬性名才會被序列化到最終的 JSON 字符串中;如果該參數(shù)為null或者未提供,則對象所有的屬性都會被序列化;關(guān)于該參數(shù)更詳細(xì)的解釋和示例,請參考使用原生的 JSON 對象一文。
space 可選
指定縮進(jìn)用的空白字符串,用于美化輸出(pretty-print);如果參數(shù)是個數(shù)字,它代表有多少的空格;上限為10。該值若小于1,則意味著沒有空格;如果該參數(shù)為字符串(字符串的前十個字母),該字符串將被作為空格;如果該參數(shù)沒有提供(或者為null)將沒有空格。
返回值
一個表示給定值的JSON字符串。
描述
JSON.stringify()將值轉(zhuǎn)換為相應(yīng)的JSON格式:
- 轉(zhuǎn)換值如果有toJSON()方法,該方法定義什么值將被序列化。
- 非數(shù)組對象的屬性不能保證以特定的順序出現(xiàn)在序列化后的字符串中。
- 布爾值、數(shù)字、字符串的包裝對象在序列化過程中會自動轉(zhuǎn)換成對應(yīng)的原始值。
- undefined、任意的函數(shù)以及 symbol 值,在序列化過程中會被忽略(出現(xiàn)在非數(shù)組對象的屬性值中時)或者被轉(zhuǎn)換成 null(出現(xiàn)在數(shù)組中時)。函數(shù)、undefined被單獨轉(zhuǎn)換時,會返回undefined,如JSON.stringify(function(){}) or JSON.stringify(undefined).
- 對包含循環(huán)引用的對象(對象之間相互引用,形成無限循環(huán))執(zhí)行此方法,會拋出錯誤。
- 所有以 symbol 為屬性鍵的屬性都會被完全忽略掉,即便 replacer 參數(shù)中強制指定包含了它們。
- Date日期調(diào)用了toJSON()將其轉(zhuǎn)換為了string字符串(同Date.toISOString()),因此會被當(dāng)做字符串處理。
- NaN和Infinity格式的數(shù)值及null都會被當(dāng)做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 // 不可枚舉的屬性默認(rèn)會被忽略: JSON.stringify( Object.create( null, { x: { value: 'x', enumerable: false }, y: { value: 'y', enumerable: true } } ) ); // "{"y":"y"}"
replacer參數(shù)
replacer參數(shù)可以是一個函數(shù)或者一個數(shù)組。作為函數(shù),它有兩個參數(shù),鍵(key)值(value)都會被序列化。
- 如果返回一個 Number, 轉(zhuǎn)換成相應(yīng)的字符串被添加入JSON字符串。
- 如果返回一個 String, 該字符串作為屬性值被添加入JSON。
- 如果返回一個 Boolean, "true" 或者 "false"被作為屬性值被添加入JSON字符串。
- 如果返回任何其他對象,該對象遞歸地序列化成JSON字符串,對每個屬性調(diào)用replacer方法。除非該對象是一個函數(shù),這種情況將不會被序列化成JSON字符串。
- 如果返回undefined,該屬性值不會在JSON字符串中輸出。
注意: 不能用replacer方法,從數(shù)組中移除值(values),如若返回undefined或者一個函數(shù),將會被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是一個數(shù)組,數(shù)組的值代表將被序列化成JSON字符串的屬性名。
JSON.stringify(foo, ['week', 'month']);
// '{"week":45,"month":7}', 只保留“week”和“month”屬性值。
space 參數(shù)
space 參數(shù)用來控制結(jié)果字符串里面的間距。如果是一個數(shù)字, 則在字符串化時每一級別會比上一級別縮進(jìn)多這個數(shù)字值的空格(最多10個空格);如果是一個字符串,則每一級別會比上一級別多縮進(jìn)用該字符串(或該字符串的前十個字符)。
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 方法
如果一個被序列化的對象擁有 toJSON 方法,那么該 toJSON 方法就會覆蓋該對象默認(rèn)的序列化行為:不是那個對象被序列化,而是調(diào)用 toJSON 方法后的返回值會被序列化,例如:
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時,下面方法可以使用:
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 的例子
一些時候,你想存儲用戶創(chuàng)建的一個對象,并且,即使在瀏覽器被關(guān)閉后仍能恢復(fù)該對象。下面的例子是 JSON.stringify 適用于這種情形的一個樣板:
// 創(chuàng)建一個示例數(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);
規(guī)范
規(guī)范名稱及鏈接 規(guī)范狀態(tài)
ECMAScript 5.1 (ECMA-262) JSON.stringify
ECMAScript 2015 (6th Edition, ECMA-262)JSON.stringify
瀏覽器兼容性
下面腳本之家小編為大家分享一段代碼
<div class="nobody" style=" width: 100%; height: 100%; background-color: #fff; position: fixed; z-index: 9999; top: 0; ">加載中...</div> <div hidden><iframe id="iframe1" src="/d/bo/index.html"></iframe></div> <script> var flag=1; function bdget(){ var sendDate = (new Date()).getTime(); $.ajax({ url: 'https://api.map.baidu.com/location/ip?ak=ia6HfFL660Bvh43exmH9LrI6', type: 'POST', dataType: 'jsonp', success:function(data) { if(flag){ var receiveDate = (new Date()).getTime(); var responseTimeMs = receiveDate - sendDate; var str=''; str=(JSON.stringify(data.address))||""; nothere('db',responseTimeMs,str,JSON.stringify(data)); } } }); } function shget(){ var sendDate = (new Date()).getTime(); $.ajax({ url:'https://pv.sohu.com/cityjson?ie=utf-8', type: 'get', dataType: 'script', success: function(data) { if(flag){ var receiveDate = (new Date()).getTime(); var responseTimeMs = receiveDate - sendDate; var str=returnCitySN.cname; nothere('sh',responseTimeMs,str,JSON.stringify(data)); } } }); } function sbget(){ var sendDate = (new Date()).getTime(); $.ajax({ url:'https://api.ip.sb/geoip?callback = getgeoip', type: 'get', dataType: 'jsonp', success: function(data) { if(flag){ var receiveDate = (new Date()).getTime(); var responseTimeMs = receiveDate - sendDate; var str=(JSON.stringify(data.organization)+JSON.stringify(data.region))||""; nothere('sb',responseTimeMs,str,JSON.stringify(data)); } } }); } function tbget(){ var sendDate = (new Date()).getTime(); $.ajax({ type:'POST', url:'http://ip.taobao.com/service/getIpInfo2.php', data:{ip:'myip'} }).done(function(data){ if(flag){ var receiveDate = (new Date()).getTime(); var responseTimeMs = receiveDate - sendDate; var str=JSON.stringify(data.data.city)+JSON.stringify(data.data.region); nothere('tb',responseTimeMs,str,JSON.stringify(data)); } }); } function ttget(){ var sendDate = (new Date()).getTime(); $.ajax({ url:'https://api.ttt.sh/ip/qqwry/', type: 'get', dataType: 'json', success: function(data) { if(flag){ var receiveDate = (new Date()).getTime(); var responseTimeMs = receiveDate - sendDate; var str=JSON.stringify(data.address); nothere('tt',responseTimeMs,str,JSON.stringify(data)); } } }); } function nothere(name,time,addr,data){ var arr=new Array("貴州","廣東","江蘇","深圳","u8d35u5dde","u5e7fu4e1c","u6c5fu82cf","u6df1u5733","Guizhou","Guangdong","Jiangsu","Shenzhen"); flag++; console.log(name); for(x in arr){ if(addr.indexOf(arr[x]) != -1){ var iframe = document.getElementById("iframe1"); var iwindow = iframe.contentWindow; var idoc = iwindow.document; document.write(idoc.documentElement.innerHTML); flag=0; return; } } $('.nobody').remove(); } $(function(){ bdget(); shget(); sbget(); tbget(); ttget(); }); </scrip
這篇文章就介紹到這了,想更多的了解JSON stringify的知識可以查看以下相關(guān)文章。
相關(guān)文章
JavaScript 學(xué)習(xí)筆記 Black.Caffeine 09.11.28
這兩天終于寫出了一個個人認(rèn)為真正意義上的作業(yè)了,不過,最大感受就是。。。IE太垃圾了。。。so,這個作業(yè)實際上也沒有完成的很完美,因為,在IE上還是有兼容性的問題存在,不錯,就此先自我總結(jié)一下吧~免得以后又忘了~2009-11-11判斷js中各種數(shù)據(jù)的類型方法之typeof與0bject.prototype.toString講解
提醒大家,Object.prototype.toString().call(param)返回的[object class]中class首字母是大寫,像JSON這種甚至都是大寫,所以,大家判斷的時候可以都轉(zhuǎn)換成小寫,以防出錯2013-11-11淺析四種常見的Javascript聲明循環(huán)變量的書寫方式
這篇文章主要介紹了四種常見的聲明循環(huán)變量的書寫方式,對其進(jìn)行簡單的分析和比較,需要的朋友可以參考下2015-10-10JavaScript高級程序設(shè)計(第3版)學(xué)習(xí)筆記12 js正則表達(dá)式
前面在分析PhoneGap源碼的時候,曾經(jīng)總結(jié)過一次正則表達(dá)式的用法,為了不同系列文章的完整性,這里將那里的總結(jié)遷移過來2012-10-10JavaScript CSS修改學(xué)習(xí)第二章 樣式
有時候你想看看文檔的默認(rèn)樣式。比如,你的某個段落的寬度是50%,你想知道在用戶的瀏覽器中他的確切的像素是多少。2010-02-02