JSON 格式

weixin_33807284發表於2018-11-20

一:JSON 格式定義

JSON(JavaScript Object Notation) 是一種輕量級的資料交換格式。 易於人閱讀和編寫。同時也易於機器解析和生成。2001年由 Douglas Crockford 提出,目的是取代繁瑣笨重的 XML 格式。

二、JSON 格式規則

  1. 複合型別的值只能是陣列或物件,不能是函式、正規表示式物件、日期物件。
  2. 簡單型別的值只有四種:字串、數值(必須以十進位制表示)、布林值和null(不能使用NaN, Infinity, -Infinity和undefined)。
  3. 字串必須使用雙引號表示,不能使用單引號。
  4. 物件的鍵名必須放在雙引號裡面。
  5. 陣列或物件最後一個成員的後面,不能加逗號。

空陣列和空物件都是合格的 JSON 值,null本身也是一個合格的 JSON 值

以下是合格的 JSON 值。

["one", "two", "three"]

{ "one": 1, "two": 2, "three": 3 }

{"names": ["張三", "李四"] }

[ { "name": "張三"}, {"name": "李四"} ]
以下是不合格的 JSON 值。

{ name: "張三", 'age': 32 }  // 屬性名必須使用雙引號

[32, 64, 128, 0xFFF] // 不能使用十六進位制值

{ "name": "張三", "age": undefined } // 不能使用undefined

{ "name": "張三",
  "birthday": new Date('Fri, 26 Aug 2011 07:13:10 GMT'),
  "getName": function() {
      return this.name;
  }
} // 不能使用函式和日期物件

三、處理 JSON 格式資料的方法

1、JSON.Stringify

1)用途
用於將一個值轉為字串。該字串符合 JSON 格式,並且可以被JSON.parse方法還原。
2)引數
JSON.stringify(value[, replacer [, space]])

2.1 value:將要序列化成 一個JSON 字串的值
2.2 replacer (可選)

  • 如果該引數是一個函式,則在序列化過程中,被序列化的值的每個屬性都會經過該函式的轉換和處理
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}.
  • 如果該引數是一個陣列,則只有包含在這個陣列中的屬性名才會被序列化到最終的 JSON 字串中。
var foo = {foundation: "Mozilla", model: "box", week: 45, transport: "car", month: 7};
JSON.stringify(foo, ['week', 'month']);  
// '{"week":45,"month":7}', 只保留“week”和“month”屬性值。
  • 如果該引數為null或者未提供,則物件所有的屬性都會被序列化;

2.3 space 引數(可選)
space 引數用來控制結果字串裡面的間距

  • 如果是數字, 則在轉換時每一級別會比上一級別縮排對應 數字值的空格(最多10個空格)

clipboard.png

  • 如果是一個字串,則每一級別加上該字串(或該字串的前十個字元)

clipboard.png

3)舉個例子

JSON.stringify('abc') // ""abc""
JSON.stringify(1) // "1"
JSON.stringify(false) // "false"
JSON.stringify([]) // "[]"
JSON.stringify({}) // "{}"

JSON.stringify([1, "false", false])
// '[1,"false",false]'

JSON.stringify({ name: "張三" })
// "{"name":"張三"}"

4)總結
先寫""轉換為字串格式,再把需要轉換的內容按照json格式的規則轉變一下,該加""的加"",然後把轉換後的內容放在""內,收工

5)特例
json格式不支援的內容會被過濾,分3種情況

  1. 原始物件

原始物件成員的值是undefined、函式或 XML 物件,這個成員會被過濾

var obj = {
  a: undefined,
  b: function () {}
};

JSON.stringify(obj) // "{}"

2.陣列
陣列的成員是undefined、函式或 XML 物件,則這些值被轉成null

var arr = [undefined, function () {}];
JSON.stringify(arr) // "[null,null]"

3.正則物件
正則物件會被轉成空物件。

JSON.stringify(/foo/) // "{}"

2、JSON.parse()

1)用途
JSON.parse方法用於將JSON格式的字串轉化成物件。
2)引數
JSON.parse(text[, reviver])
2.1 text
要被解析成JavaScript值的字串

2.2 reviver 可選
轉換器, 如果傳入該引數(函式),可以用來修改解析生成的原始值,呼叫時機在parse函式返回之前。

JSON.parse('{"p": 5}', function (k, v) {
    if(k === '') return v;     // 如果到了最頂層,則直接返回屬性值,
    return v * 2;              // 否則將屬性值變為原來的 2 倍。
});                            // { p: 10 }

3)舉個例子

JSON.parse('{}') // {}
JSON.parse('true') // true
JSON.parse('"foo"') // "foo"
JSON.parse('[1, 5, "false"]') // [1, 5, "false"]
JSON.parse('null') // null

var o = JSON.parse('{"name": "張三"}');
o.name // 張三

4)特例
如果傳入的字串不是有效的JSON格式,JSON.parse方法將報錯。

JSON.parse("'String'") // illegal single quotes
// SyntaxError: Unexpected token ILLEGAL

5)遇到的坑
紅框裡面一個加的是單引號,一個加雙引號,兩個執行起來都沒有錯。
這代表是用於表示值為字串的引號,使用單雙引號都可以,但表示內容為json格式的引號必須寫雙引號
clipboard.png

部分內容源於mdn文件
JSON.parse()
JSON.stringify()

相關文章