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ù)更詳細的解釋和示例,請參考使用原生的 JSON 對象一文。
space 可選
指定縮進用的空白字符串,用于美化輸出(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
// 不可枚舉的屬性默認會被忽略:
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ù)字, 則在字符串化時每一級別會比上一級別縮進多這個數(shù)字值的空格(最多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 方法就會覆蓋該對象默認的序列化行為:不是那個對象被序列化,而是調(diào)用 toJSON 方法后的返回值會被序列化,例如:
var obj = {
foo: 'foo',
toJSON: function () {
return 'bar';
}
};
JSON.stringify(obj); // '"bar"'
JSON.stringify({x: obj}); // '{"x":"bar"}'
注意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 結(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
這兩天終于寫出了一個個人認為真正意義上的作業(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)變量的書寫方式,對其進行簡單的分析和比較,需要的朋友可以參考下2015-10-10
JavaScript高級程序設(shè)計(第3版)學(xué)習(xí)筆記12 js正則表達式
前面在分析PhoneGap源碼的時候,曾經(jīng)總結(jié)過一次正則表達式的用法,為了不同系列文章的完整性,這里將那里的總結(jié)遷移過來2012-10-10
JavaScript CSS修改學(xué)習(xí)第二章 樣式
有時候你想看看文檔的默認樣式。比如,你的某個段落的寬度是50%,你想知道在用戶的瀏覽器中他的確切的像素是多少。2010-02-02

