| 特性 | Cookie | localStorage | sessionStorage |
|---|---|---|---|
| 容量 | ~4 KB / 個 | ~5-10 MB | ~5-10 MB |
| 生命週期 | 可設定過期時間 | 永久(手動清除前) | 分頁/視窗關閉即銷毀 |
| 自動隨請求送出 | ✅ 是 | ❌ 否 | ❌ 否 |
| 同源策略 | Domain/Path 可跨子域 | 嚴格同源 (scheme+host+port) | 嚴格同源 + 同分頁 |
| API 風格 | 字串解析 document.cookie | Key-Value setItem/getItem | Key-Value setItem/getItem |
| 支援瀏覽器 | 所有(含 IE6+) | IE8+ / 所有現代 | IE8+ / 所有現代 |
// cookie.js
export function setCookie(name, value, options = {}) {
if (!name) throw new Error('Cookie name required');
const { expires, path = '/', domain, secure, sameSite = 'Lax' } = options;
let cookieStr = `${encodeURIComponent(name)}=${encodeURIComponent(value)}`;
if (expires) {
const date = expires instanceof Date ? expires : new Date(Date.now() + expires * 1000);
cookieStr += `; Expires=${date.toUTCString()}`;
}
cookieStr += `; Path=${path}`;
if (domain) cookieStr += `; Domain=${domain}`;
if (secure) cookieStr += '; Secure';
cookieStr += `; SameSite=${sameSite}`;
document.cookie = cookieStr;
}
export function getCookie(name) {
const match = document.cookie.match(new RegExp('(^|;\\s*)' + encodeURIComponent(name) + '=([^;]*)'));
return match ? decodeURIComponent(match[2]) : null;
}
export function removeCookie(name, options = {}) {
setCookie(name, '', { ...options, expires: -1 });
}
// 存取(三種語法等價)
localStorage.setItem('token', 'abc123');
localStorage.token = 'abc123';
localStorage['token'] = 'abc123';
const token = localStorage.getItem('token');
const token2 = localStorage.token;
const token3 = localStorage['token'];
// 刪除單筆
localStorage.removeItem('token');
// 清空全部
localStorage.clear();
// 遍歷所有鍵值
for (let i = 0; i < localStorage.length; i++) {
const key = localStorage.key(i);
console.log(key, localStorage.getItem(key));
}
const user = { id: 1, name: 'Alice', roles: ['admin'] };
localStorage.setItem('user', JSON.stringify(user));
const saved = JSON.parse(localStorage.getItem('user') || 'null');
window.addEventListener('storage', e => {
if (e.key === 'user' && e.newValue !== e.oldValue) {
console.log('其他分頁更新 user:', JSON.parse(e.newValue));
// 觸發 UI 同步
}
});
idb (Google)、Dexie.js、localForage(統一 API 介面)需要自動隨 HTTP 請求送到後端?
├─ 是 → Cookie (設定 HttpOnly、Secure、SameSite)
└─ 否 → 資料量 > 5MB 或需索引查詢?
├─ 是 → IndexedDB (配合 idb/Dexie)
└─ 否 → 需跨分頁共享且持久化?
├─ 是 → localStorage
└─ 否 → sessionStorage (分頁隔離、臨時狀態)
try-catch 包裹。現代 Web 應用通常採用「HttpOnly Cookie 存 Token + localStorage 存非敏感偏好/快取 + IndexedDB 存大量離線資料」的分層策略。理解各機制特性與限制,才能打造安全、高效、可維護的本地儲存架構。