該函數的作用是:系列化對象
系列化對象說白了就是把對象的類型轉換為字符串類型
語法
JSON.stringify(value[, replacer [, space]])
- value
將要序列化成 一個JSON 字符串的值。 - replacer 可選
可以為數組或函數
- 如果為數組:則只有包含在這個數組中的屬性名才會被序列化到最終的 JSON 字符串中,replacer作key值(這個在講實例的時候就知道這個key是干嘛的了,先記住就好)
- 如果為函數:則把系列化后的每一個對象(記住是每一個)傳進方法里面進行處理
- space 可選
指定縮進用的空白字符串
- 如果省略的話,那么顯示出來的值就沒有分隔符。直接輸出來
- 如果是一個數字的話,那么它就定義縮進幾個字符,范圍是:0到10(數字小於1,則默認為0,大於10,則默認為10)
- 如果是一些轉義字符,比如“\t”,表示回車,那么它每行一個回車。
- 如果僅僅是字符串,就在每行輸出值的時候把這些字符串附加上去就OK。當然,最大長度也是10個字符
實例說明
注意:以下的輸出結果都是string類型的,為了容易看就沒有用單引號‘’表明是字符串類型
只有一個參數
參數為對象:
var students = new Array(); students[0] = "pika"; students[1] = "hello"; students[2] = "hey"; var json = JSON.stringify(students); alert(json);
輸出結果:["pika","hello","hey"]
如果不用JSON.stringify()函數,直接alert(students),那么
輸出結果:pika,hello,hey
從這里到對比可以比較直觀的看出JSON.stringify()函數的作用啦
看一下其他例子:
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
從這些例子中可以看出:undefined、任意的函數以及 symbol 值,在序列化過程中會被忽略(出現在非數組對象的屬性值中時)或者被轉換成 null(出現在數組中時)
再看最后一個例子
JSON.stringify( Object.create( null, { x: { value: 'x', enumerable: false }, y: { value: 'y', enumerable: true } } ) );
從例子中可以看出:不可枚舉的屬性會被忽略
有兩個參數,第二個參數為函數
函數例子:
function replacer(key, value) { if (typeof value === "string") { return undefined; } return value; }
可以看出有一個key值,一個value值,還記得一開始說的第二個參數作key值嗎?
實例:
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); //輸出結果:{"week":45,"month":7}
就是把第一個值傳去函數進行相關的處理
有兩個參數,第二個參數為數組
第一個參數為數組
var students = new Array(); students[0] = "pika"; students[1] = "hello"; students[2] = "hey"; var stu= new Array(); stu[0] = "how"; stu[1] = "are"; stu[2] = "u"; var json = JSON.stringify(students,stu); alert(json); //輸出結果:["pika","hello","hey"]
結果是只有第一個值序列化了,第二個被忽略了
第一個參數為對象
var students = new Object(); students.name = "pika"; students.age = 19; students.qq = "12345678"; var stu= new Array(); stu[0] = "name"; stu[1] = "qq"; var json = JSON.stringify(students,stu); alert(json); //輸出結果:{"name":"pika","qq":"12345678"}
數組的值代表將被序列化成JSON字符串的屬性名
stu數組沒有“age”,所以students對象的“age”屬性沒有顯示
有三個參數
前面說到第三個參數就是用來縮進或者直接添加字符串在序列化對象的前面,所以直接看例子就行啦,注意最多只能10個縮進或字符
JSON.stringify({ a: 2 }, null, " "); // 輸出結果:{\n "a": 2\n} JSON.stringify({ uno: 1, dos : 2 }, null, '\t') /* 輸出結果: { "uno": 1, "dos": 2 } */ var students = new Object(); students.name = "pika"; students.age = 19; students.qq = "12345678"; var stu= new Array(); stu[0] = "name"; stu[1] = "qq"; var json = JSON.stringify(students,stu,"test") alert(json); /* 輸出結果: { test"name": "pika", test"qq": "12345678" } */
總結
最后來總結一下,JSON.stringify()函數是用來序列化對象的,無論輸入什么,輸出的都是字符串類型,可以按自己的需求來定制如何序列化,輸出結果是怎樣的格式