js JSON.stringify()基礎(chǔ)詳解
JSON.stringify() 方法是將一個(gè)JavaScript值(對象或者數(shù)組)轉(zhuǎn)換為一個(gè) JSON字符串,如果指定了replacer是一個(gè)函數(shù),則可以選擇性的替換值,或者如果指定了replacer是一個(gè)數(shù)組,可選擇性的僅包含數(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字符串。
描述
JSON.stringify()將值轉(zhuǎn)換為相應(yīng)的JSON格式:
- 轉(zhuǎn)換值如果有toJSON()方法,該方法定義什么值將被序列化。
- 非數(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í))。函數(shù)、undefined被單獨(dú)轉(zhuǎn)換時(shí),會(huì)返回undefined,如JSON.stringify(function(){}) or JSON.stringify(undefined).
- 對包含循環(huán)引用的對象(對象之間相互引用,形成無限循環(huán))執(zhí)行此方法,會(huì)拋出錯(cuò)誤。
- 所有以 symbol 為屬性鍵的屬性都會(huì)被完全忽略掉,即便 replacer 參數(shù)中強(qiáng)制指定包含了它們。
- Date日期調(diào)用了toJSON()將其轉(zhuǎn)換為了string字符串(同Date.toISOString()),因此會(huì)被當(dāng)做字符串處理。
- NaN和Infinity格式的數(shù)值及null都會(huì)被當(dāng)做null。
- 其他類型的對象,包括Map/Set/weakMap/weakSet,僅會(huì)序列化可枚舉的屬性。
實(shí)例
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í)每一級(jí)別會(huì)比上一級(jí)別縮進(jìn)多這個(gè)數(shù)字值的空格(最多10個(gè)空格);如果是一個(gè)字符串,則每一級(jí)別會(huì)比上一級(jí)別多縮進(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不是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);
規(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的知識(shí)可以查看以下相關(guān)文章。
相關(guān)文章
javascript日期處理函數(shù),性能優(yōu)化批處理
這篇文章主要介紹了javascript日期處置函數(shù),對批處理做了性能優(yōu)化,需要的朋友可以參考下2015-09-09
javascript基礎(chǔ)知識(shí)大集錦(二) 推薦收藏
正則表達(dá)式 call(),apply(),callee,caller,cookie方法,setInterval(),clearInterval(),setTimeout() ,clearTimeout()2011-01-01
window.parent與window.openner區(qū)別介紹
今天總結(jié)一下js中幾個(gè)對象的區(qū)別和用法,對這幾個(gè)概念混淆的朋友可以看看2012-04-04
Javascript模塊化編程(一)AMD規(guī)范(規(guī)范使用模塊)
這個(gè)系列的第一部分介紹了Javascript模塊的基本寫法,今天介紹如何規(guī)范地使用模塊,先想一想,為什么模塊很重要?接下來為您詳細(xì)介紹,感興趣的朋友可以了解下啊2013-01-01
JavaScript Undefined,Null類型和NaN值區(qū)別
js中一些空值問題,未定義等一系列的區(qū)別說明2008-10-10

