萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML5 教學

為什麼要善用 HTML5 本地儲存:localStorage、sessionStorage 與 IndexedDB 完整比較

前言

HTML5 引入 Web Storage API(localStorage、sessionStorage)與 IndexedDB,讓瀏覽器擁有強大的客戶端儲存能力,徹底改變「無狀態 HTTP」的開發範式。本文深入比較三者特性、適用場景、容量限制、效能與最佳實踐。

快速比較表

特性localStoragesessionStorageIndexedDB
生命週期永久(手動清除或用戶清除瀏覽資料才消失)分頁/視窗關閉即清除永久(手動清除或配額淘汰)
作用域同源(協定+域名+埠),所有分頁共享同源,每個分頁獨立同源,所有分頁共享
容量~5 MB(各瀏覽器略異)~5 MB動態配額(通常數百 MB 至數 GB,視磁碟空間)
資料型別字串(需自行 JSON.stringify/parse)字串任意結構化物件、Blob、File、ArrayBuffer
查詢能力鍵值對,無索引、無查詢鍵值對索引、游標、範圍查詢、事務
同步/非同步同步(阻塞主執行緒)同步非同步(Promise/事件),不阻塞主執行緒
支援度IE8+、所有現代瀏覽器IE8+、所有現代瀏覽器IE10+、所有現代瀏覽器(Safari 7.1+ 部分支援)
儲存事件storage 事件(跨分頁同步)無跨分頁事件無內建跨分頁事件(可自行廣播)

localStorage:持久化鍵值對

基本操作

// 寫入
localStorage.setItem('token', 'abc123');
localStorage.setItem('user', JSON.stringify({ id: 1, name: 'Alice' }));

// 讀取
const token = localStorage.getItem('token');
const user = JSON.parse(localStorage.getItem('user') || 'null');

// 刪除單一/全部
localStorage.removeItem('token');
localStorage.clear();

// 遍歷所有鍵
for (let i = 0; i < localStorage.length; i++) {
  const key = localStorage.key(i);
  console.log(key, localStorage.getItem(key));
}

適用場景

  • 用戶偏好設定(主題、語言、版面配置)
  • JWT/Access Token、Refresh Token 持久化
  • 購物車草稿、表單暫存(跨分頁同步)
  • 靜態資源快取(HTML 片段、字典資料)

注意事項

  • 同步阻塞:大量讀寫會卡住主執行緒,避免在關鍵路徑大量操作。
  • 配額超過拋出 QuotaExceededError:需 try-catch 處理。
  • 無過期機制:自行在 value 中存入 expiry 時間戳,讀取時檢查清理。
  • 安全性:XSS 攻擊可竊取所有資料,嚴禁存放敏感資訊(密碼、信用卡、PII)。HttpOnly Cookie 才是 Token 的正規棲身之處。

sessionStorage:分頁級暫存

特性差異

  • 分頁關閉即清除,適合單一工作階段的暫態資料。
  • 同源不同分頁不共享,各自獨立實例。
  • 無 storage 事件,無法跨分頁同步。

適用場景

  • 多步驟表單暫存(精靈式註冊、結帳流程)
  • 單分頁編輯器草稿自動儲存
  • 分頁間隔離的暫態狀態(如不同分頁開啟不同帳號的管理後台)

IndexedDB:瀏覽器端 NoSQL 資料庫

核心概念

  • Database:版本化,升級時觸發 onupgradeneeded 建立/修改 Object Store、Index。
  • Object Store:類似資料表,儲存任意物件,需指定 keyPath(主鍵路徑)或自動產生鍵。
  • Index:非主鍵欄位建立索引,支援範圍查詢、排序、唯一約束。
  • Transaction:readonly、readwrite、versionchange,保證 ACID。
  • Cursor:遍歷結果集,支援 continue、advance、continuePrimaryKey。

基本 CRUD 範例(Promise 封裝)

function openDB() {
  return new Promise((resolve, reject) => {
    const req = indexedDB.open('MyAppDB', 1);
    req.onupgradeneeded = e => {
      const db = e.target.result;
      if (!db.objectStoreNames.contains('users')) {
        const store = db.createObjectStore('users', { keyPath: 'id', autoIncrement: true });
        store.createIndex('email', 'email', { unique: true });
      }
    };
    req.onsuccess = () => resolve(req.result);
    req.onerror = () => reject(req.error);
  });
}

async function addUser(user) {
  const db = await openDB();
  return new Promise((resolve, reject) => {
    const tx = db.transaction('users', 'readwrite');
    tx.objectStore('users').add(user);
    tx.oncomplete = () => resolve();
    tx.onerror = () => reject(tx.error);
  });
}

async function getUserByEmail(email) {
  const db = await openDB();
  return new Promise((resolve, reject) => {
    const tx = db.transaction('users', 'readonly');
    const idx = tx.objectStore('users').index('email');
    const req = idx.get(email);
    req.onsuccess = () => resolve(req.result);
    req.onerror = () => reject(req.error);
  });
}

適用場景

  • 離線優先應用(PWA):大量資料本地快取、背景同步。
  • 客戶端搜尋/篩選/排序大量資料(如通訊錄、產品目錄、日誌)。
  • 大型二進位資料儲存(圖片、音訊、PDF Blob)。
  • 複雜狀態管理(Redux 持久化、本地優先架構)。

工具庫推薦

  • idb:輕量 Promise 封裝(~2KB),官方推薦。
  • Dexie.js:類 SQL 語法、TypeScript 一級支援、關聯查詢、同步協議。
  • localForage:統一 localStorage/IndexedDB/WebSQL API,自動降級。

綜合選型決策樹

需要持久化嗎?
├─ 否 → 需跨分頁共享嗎?
│       ├─ 是 → 考慮 BroadcastChannel + memory store
│       └─ 否 → 變數/React Context/Vue Pinia 即可
└─ 是 → 資料結構複雜/需查詢/超過 5MB/含 Blob?
        ├─ 是 → IndexedDB (搭配 idb/Dexie)
        └─ 否 → 需跨分頁即時同步?
                ├─ 是 → localStorage + storage 事件
                └─ 否 → sessionStorage (單分頁) 或 localStorage (跨分頁但不同步即時性)

最佳實踐總結

  1. 敏感資料走 HttpOnly Cookie,Web Storage 僅存非敏感、可公開資料。
  2. 封裝 Storage Service:統一序列化、錯誤處理、過期清理、TypeScript 型別。
  3. 監控配額:navigator.storage.estimate() 取得用量/配額,提前預警。
  4. 遷移策略:IndexedDB 版本升級務必在 onupgradeneeded 正確處理資料遷移。
  5. 隱私合規:GDPR/CCPA 要求用戶可刪除本地資料,提供「清除本地資料」功能並記錄審計日誌。

結語

HTML5 本地儲存三劍客各有分工:localStorage 適合簡單持久鍵值、sessionStorage 適合分頁隔離暫態、IndexedDB 適合結構化大數據與離線應用。理解其特性邊界、同步/非同步模型、安全性限制,並善用成熟庫簡化操作,即能構建高效能、可離線、用戶體驗優異的現代 Web 應用。

copyright © 萬盛學電腦網 all rights reserved