HTML5 引入 Web Storage API(localStorage、sessionStorage)與 IndexedDB,讓瀏覽器擁有強大的客戶端儲存能力,徹底改變「無狀態 HTTP」的開發範式。本文深入比較三者特性、適用場景、容量限制、效能與最佳實踐。
| 特性 | localStorage | sessionStorage | IndexedDB |
|---|---|---|---|
| 生命週期 | 永久(手動清除或用戶清除瀏覽資料才消失) | 分頁/視窗關閉即清除 | 永久(手動清除或配額淘汰) |
| 作用域 | 同源(協定+域名+埠),所有分頁共享 | 同源,每個分頁獨立 | 同源,所有分頁共享 |
| 容量 | ~5 MB(各瀏覽器略異) | ~5 MB | 動態配額(通常數百 MB 至數 GB,視磁碟空間) |
| 資料型別 | 字串(需自行 JSON.stringify/parse) | 字串 | 任意結構化物件、Blob、File、ArrayBuffer |
| 查詢能力 | 鍵值對,無索引、無查詢 | 鍵值對 | 索引、游標、範圍查詢、事務 |
| 同步/非同步 | 同步(阻塞主執行緒) | 同步 | 非同步(Promise/事件),不阻塞主執行緒 |
| 支援度 | IE8+、所有現代瀏覽器 | IE8+、所有現代瀏覽器 | IE10+、所有現代瀏覽器(Safari 7.1+ 部分支援) |
| 儲存事件 | storage 事件(跨分頁同步) | 無跨分頁事件 | 無內建跨分頁事件(可自行廣播) |
// 寫入
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));
}
expiry 時間戳,讀取時檢查清理。storage 事件,無法跨分頁同步。onupgradeneeded 建立/修改 Object Store、Index。keyPath(主鍵路徑)或自動產生鍵。readonly、readwrite、versionchange,保證 ACID。continue、advance、continuePrimaryKey。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);
});
}
需要持久化嗎?
├─ 否 → 需跨分頁共享嗎?
│ ├─ 是 → 考慮 BroadcastChannel + memory store
│ └─ 否 → 變數/React Context/Vue Pinia 即可
└─ 是 → 資料結構複雜/需查詢/超過 5MB/含 Blob?
├─ 是 → IndexedDB (搭配 idb/Dexie)
└─ 否 → 需跨分頁即時同步?
├─ 是 → localStorage + storage 事件
└─ 否 → sessionStorage (單分頁) 或 localStorage (跨分頁但不同步即時性)
navigator.storage.estimate() 取得用量/配額,提前預警。onupgradeneeded 正確處理資料遷移。HTML5 本地儲存三劍客各有分工:localStorage 適合簡單持久鍵值、sessionStorage 適合分頁隔離暫態、IndexedDB 適合結構化大數據與離線應用。理解其特性邊界、同步/非同步模型、安全性限制,並善用成熟庫簡化操作,即能構建高效能、可離線、用戶體驗優異的現代 Web 應用。