JSON 與 JavaScript 物件字面值的差異

簡短版本

JavaScript 物件字面值是原始碼；JSON 是資料交換格式。兩者重疊的部分多到容易混淆，但規則不同：JSON 的鍵與字串必須用雙引號；JSON 沒有註解；JSON 也無法表示函式、undefined、NaN、Infinity、Date 物件或正規式。

合法的 JSON 值

一份 JSON 文件可以包含物件、陣列、字串、數字、布林或 null。字串必須用雙引號；物件的鍵也必須是用雙引號的字串。數字不能使用 JavaScript 才有的形式，例如十六進位、NaN、Infinity 或數字分隔符。

• 合法 JSON 字串："hello"
• 合法 JSON 布林：true
• 合法 JSON null：null
• 合法 JSON 物件鍵："name"

合法的 JavaScript 但不是合法 JSON

{ name: 'Ada', active: true, createdAt: new Date(), onSave() { return true }, tags: ['dev',], }

對應的合法 JSON

{ "name": "Ada", "active": true, "createdAt": "2026-05-13T00:00:00.000Z", "tags": ["dev"] }

為什麼 API 會拒絕長得像 JavaScript 的資料

API 伺服器通常用 JSON 解析器解析請求主體，而不是 JavaScript 引擎。這是安全與互通性考量：任何語言都能解析同樣的資料，而不需要執行程式碼。如果請求主體含有註解、方法、undefined 或 new Date()，伺服器就不能安全地把它當作純資料處理。

如何安全地轉換

把可執行或語言特有的值換成純資料。日期改用字串，缺漏值改用 null 或直接省略鍵，註解搬到文件裡，函式則用顯式資料欄位（例如策略名稱或型別值）來表示。