HOWTO · JavaScript
在 JavaScript 中將 JSON 轉換為物件
本教程演示瞭如何安全地將 JSON 字串轉換為物件。
本頁內容
使用 JSON.parse() 將 JSON 格式的字串轉換為 JavaScript 值。如果 JSON 文件表示物件,解析結果就是可供讀取及使用其屬性的 JavaScript 物件。解析不會驗證應用程式規則、不會將日期字串轉成 Date 物件,也不會讓不可信的值適合直接用於 HTML。以下範例說明基本轉換、錯誤格式輸入的處理、巢狀屬性的存取,以及日期轉換。
JSON 解析會傳回什麼
JSON 是一種文字格式,可表示物件、陣列、字串、數字、布林值和 null 等值。JSON 字串本身是文字;解析後,JavaScript 會傳回對應的值。表示物件的文件會產生物件,JSON 陣列則會產生陣列。解析結果不一定是物件,因此程式應考量預期輸入的資料結構。
JSON 語法比 JavaScript 物件常值語法嚴格。物件鍵和值字串都必須使用雙引號,而且 JSON 不允許註解、函式或尾端逗號。例如,{"name":"Ari","active":true} 是 JSON 文字,但 {name: 'Ari', active: true} 不是。正因為這些語法規則,JavaScript 物件常值不一定能直接傳給解析器。
使用 JSON.parse() 解析 JSON 字串
將字串傳給 JSON.parse(),再像使用其他 JavaScript 資料一樣使用傳回的值。以下範例會解析一筆人物資料,並讀取其中兩個屬性:
執行此範例:
本節中的程式碼以及顯示的標籤或輸出仍為英文。
const jsonText = '{"name":"Ari","age":30}';
const person = JSON.parse(jsonText);
console.log(person.name);
console.log(person.age);
第一個輸出是姓名,第二個是數字形式的年齡。由於 JSON 文件表示物件,因此可以存取其屬性。如果輸入已經是 JavaScript 物件,不要為了再次解析而先將它轉成字串;JSON.parse() 接受的是 JSON 文字。
處理無效的 JSON
如果字串格式錯誤或不符合有效的 JSON 語法,JSON.parse() 會擲回 SyntaxError。若輸入可能來自檔案、請求或其他不一定符合預期格式的來源,請捕捉這個錯誤。將錯誤處理放在解析操作附近,讓呼叫端能決定後續如何處理:
本節中的程式碼以及顯示的標籤或輸出仍為英文。
const jsonText = '{"name":"Ari",}';
let person;
try {
person = JSON.parse(jsonText);
console.log(person.name);
} catch (error) {
console.log("Could not parse JSON");
}
這個範例會針對尾端逗號格式錯誤,輸出簡短的應用程式訊息。在正式環境的程式碼中,可以透過應用程式的記錄系統回報錯誤,或顯示實用的驗證訊息。避免記錄敏感輸入,也不要向使用者揭露內部錯誤細節。解析成功只表示文字符合 JSON 語法;使用資料前,仍應另外檢查必要屬性及值的型別。
讀取巢狀值
巢狀物件和陣列會解析為巢狀的 JavaScript 值,因此可使用一般的屬性和索引表示法來存取。下一個範例會從地址物件讀取城市,並取得陣列中的第一個項目:
本節中的程式碼以及顯示的標籤或輸出仍為英文。
const jsonText = '{"person":{"name":"Ari","address":{"city":"Oslo"}},"scores":[8,9]}';
const data = JSON.parse(jsonText);
console.log(data.person.address.city);
console.log(data.scores[0]);
資料結構是否符合預期很重要:如果缺少 person、address 或 scores,或它們的型別不同,直接存取屬性可能無法取得應用程式預期的值。若資料有既定結構,請先驗證解析後的值,再存取深層屬性。解析也不會合併物件或轉換屬性名稱;它會依照 JSON 文字所表示的內容重建各個值。
解析後轉換日期字串
JSON 沒有日期型別,因此日期以字串表示。解析後,這些字串仍維持不變。解析完成後,使用 new Date() 明確轉換已知的日期屬性;若來源表示特定時間點,請使用包含時區標記的標準 ISO 格式值:
本節中的程式碼以及顯示的標籤或輸出仍為英文。
const jsonText = '{"createdAt":"2024-01-15T12:30:00Z"}';
const data = JSON.parse(jsonText);
const createdAt = new Date(data.createdAt);
console.log(createdAt instanceof Date);
new Date() 會從字串建立 JavaScript Date;不加 new 的 Date() 則會傳回字串。日期解析結果可能受輸入格式影響,因此應在資料進入應用程式時統一日期格式;若來源不可信,也要檢查產生的日期是否有效。只轉換應用程式視為日期的欄位;JSON 解析器不會自動推斷日期。