我們可以先看下面的例子:
JavaScript 這種程式語言最初是為了替 Netscape Navigator 提供一種頁面腳本語言。它常被誤認為是 Java 的子集,但事實並非如此——它是一種語法近似 C 語言、並支援物件導向的 Scheme-like 語言,最後以 ECMAScript 第三版進行標準化。
JSON 是 JavaScript 物件語法的一個子集,因此能在該語言中被清晰運用。
var myJSONObject = {"bindings": [ {"ircEvent": "PRIVMSG", "method": "newURI", "regex": "^https://.*"}, {"ircEvent": "PRIVMSG", "method": "deleteURI", "regex": "^delete.*"}, {"ircEvent": "PRIVMSG", "method": "randomURI", "regex": "^random.*"} ] };
以上範例建立了一個含單一成員 bindings 的物件,此成員是一個包含三個物件(各有 ircEvent、method 與 regex)的陣列。成員可透過 . 或下標運算子來存取:
myJSONObject.bindings[0].method // "newURI"
為了把 JSON 文字轉為物件,可以使用 eval() 函式,它會呼叫 JavaScript 編譯器。由於 JSON 是 JavaScript 的子集,編譯器能正確解析文字並產生物件結構。文字必須括在括號中,以避免語法歧義:
var myObject = eval('(' + myJSONtext + ')');
eval 函式非常快,但它能編譯執行任何 JavaScript 程式,因此存在安全問題,只應在來源可信且完善時使用。在使用 XMLHttpRequest 的 Web 應用中,頁面之間只允許同源通訊,因此通常是可信的;但若伺服器沒有嚴謹的 JSON 編碼,或未做嚴格的輸入驗證,就可能傳送含危險腳本的不安全 JSON 文字,而 eval 會執行這些惡意腳本。
使用 JSON 解析器可以防止這類事件,它只辨識 JSON 文字並拒絕所有腳本。瀏覽器原生 JSON 解析器的速度也遠快於 eval。未來的 ECMAScript 標準預計將支援原生 JSON:
var myObject = JSON.parse(myJSONtext, reviver);
一個替換函式(reviver function)作為可選參數,會對最終結果每一層的鍵與值呼叫,每個值都被 reviver 的回傳值取代。這可以用來把一般類別轉成偽類別的實例,或把日期字串轉為日期物件:
myData = JSON.parse(text, function (key, value) { var type; if (value && typeof value === 'object') { type = value.type; if (typeof type === 'string' && typeof window[type] === 'function') { return new (window[type])(value); } } return value; });
它進行反向操作,把 JavaScript 資料結構轉為 JSON 文字。JSON 不支援循環資料結構,因此要小心別把循環結構傳給它:
var myJSONText = JSON.stringify(myObject, replacer);
若 stringify 發現某物件帶有 toJSON 方法,會執行該方法並回傳其結果,讓物件能自行決定自己的 JSON 表現。stringifier 也可攜帶一個可選的字串陣列,用來選擇要包含在 JSON 文字中的屬性;或攜帶一個可選的替代(replacer)函式,它會對結構中每個值(在其 toJSON 之後)呼叫,並以回傳值進行字串化。若未提供陣列或替代函式,預設會忽略被繼承的屬性;若想要包含所有繼承屬性,可提供一個簡單的替代函式:
var myJSONText = JSON.stringify(myObject, function (key, value) { return value; });
JSON 中無法表達的值(如函式與 undefined)會被排除,無法確定的數量會被替換為 null。若要替換其他值,可用替代函式:
function replacer(key, value) { if (typeof value === 'number' && !isFinite(value)) { return String(value); } return value; }
開放原始碼的 JSON 解析器與 stringifier 皆可取得,經過 minified 之後可以小於 2.5K。