萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 解析 JSON 完整指南:從 eval 到 JSON.parse 安全最佳實踐

JSON 數據來源

  • 後端 API 返回 (Content-Type: application/json)
  • 本地存儲 localStorage.getItem('key')
  • 配置文件、靜態資源
  • 第三方嵌入腳本注入

解析方法演進

❌ 遠古時期:eval() (極度危險,禁止使用)

// 絕對不要這樣做!
var jsonStr = '{"name":"Alice"}';
var obj = eval('(' + jsonStr + ')'); // 執行任意代碼風險

風險:攻擊者注入 {"name": "alert(1)"} 或惡意代碼,eval 會執行。

⚠️ 過渡期:new Function() / json2.js polyfill

// 略好於 eval,但仍屬動態代碼執行,CSP 策略可能禁止
var parse = new Function('return ' + jsonStr)();

✅ 現代標準:JSON.parse() (ES5+,所有現代瀏覽器原生支持)

var jsonStr = '{"name":"Alice","age":25,"skills":["JS","Node"]}';
var obj = JSON.parse(jsonStr);

console.log(obj.name);      // "Alice"
console.log(obj.skills[1]); // "Node"

// 可選 reviver 函數:解析過程中轉換值
var obj2 = JSON.parse(jsonStr, function(key, value) {
  if (key === 'age') return value + 1; // 年齡 +1
  return value;
});
console.log(obj2.age); // 26

序列化:JSON.stringify()

var obj = { name: 'Bob', age: 30, toJSON: function() { return {name: this.name}; } };

// 基本用法
JSON.stringify(obj);                    // '{"name":"Bob","age":30}'
JSON.stringify(obj, null, 2);           // 格式化輸出 (2 空格縮進)
JSON.stringify(obj, ['name']);          // 白名單過濾:只保留 name

// 自定義轉換
JSON.stringify(obj, function(key, value) {
  if (typeof value === 'string') return value.toUpperCase();
  return value;
}); // '{"name":"BOB","age":30}'

安全解析最佳實踐

  1. 永遠使用 JSON.parse(),不使用 eval/new Function
  2. 設置 CSP:Content-Security-Policy: script-src 'self'; 禁用內聯腳本與 eval
  3. 輸入驗證:解析前檢查 Content-Type、長度限制、結構校驗
  4. 錯誤處理:包裹 try-catch,避免異常中斷主流程
function safeParse(jsonStr, fallback = null) {
  if (typeof jsonStr !== 'string') return fallback;
  try {
    return JSON.parse(jsonStr);
  } catch (e) {
    console.warn('JSON 解析失敗:', e.message, jsonStr.slice(0, 100));
    return fallback;
  }
}

// 使用
var data = safeParse(localStorage.getItem('userPrefs'), { theme: 'light' });

常見異常數據處理

性能優化

  • 大數據量解析:流式解析 (oboe.js, JSONStream) 避免一次性載入內存
  • 熱路徑:避免重複 parse/stringify,保持對象引用傳遞
  • Web Worker 解析:大 JSON 移至 Worker 線程,postMessage 返回結果

Node.js 額外支持

// require 直接加載 .json 文件 (同步、緩存)
const config = require('./config.json'); 

// fs 異步讀取解析
const fs = require('fs').promises;
const data = JSON.parse(await fs.readFile('data.json', 'utf8'));
copyright © 萬盛學電腦網 all rights reserved
數據類型JSON.parse 行為處理建議
undefined語法錯誤發送前轉為 null 或省略字段
Function語法錯誤序列化時用 toString() 或忽略
Symbol語法錯誤序列化時轉為字符串 Symbol(x).toString()
BigInt語法錯誤 (ES2020)用 json-bigint 庫或轉字符串 n.toString() + 'n'
Date自動調用 .toJSON() → ISO 字符串解析時用 reviver 還原 new Date(str)
RegExp/Error序列化為 {}手動轉換屬性
循環引用拋出 TypeError用 flatted 庫或自定義 replacer 打破循環