萬盛學電腦網

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

JavaScript 瀏覽器本地儲存完整指南:Cookie、localStorage、sessionStorage 與 IndexedDB 選型建議

三大主流儲存機制對比

特性CookielocalStoragesessionStorage
容量~4 KB / 個~5-10 MB~5-10 MB
生命週期可設定過期時間永久(手動清除前)分頁/視窗關閉即銷毀
自動隨請求送出✅ 是❌ 否❌ 否
同源策略Domain/Path 可跨子域嚴格同源 (scheme+host+port)嚴格同源 + 同分頁
API 風格字串解析 document.cookieKey-Value setItem/getItemKey-Value setItem/getItem
支援瀏覽器所有(含 IE6+)IE8+ / 所有現代IE8+ / 所有現代

Cookie:傳統但仍不可或缺

適用場景

  • 身分驗證 Token(需自動隨請求送達後端)
  • 追蹤用戶偏好(需跨子域共享)
  • 伺服器端需讀取的資料

封裝工具函式(ES6 模組風格)

// 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 / sessionStorage:現代首選

基本 API

// 存取(三種語法等價)
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));
}

儲存物件/陣列(自動 JSON 序列化)

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 同步
  }
});

IndexedDB:大量結構化資料的終極選擇

  • 容量:數百 MB 至數 GB(視瀏覽器/裝置)
  • 支援索引、游標、事務、查詢
  • 適合離線優先 App、大量快取、客戶端搜尋
  • 建議使用封裝庫:idb (Google)、Dexie.js、localForage(統一 API 介面)

選型決策樹

需要自動隨 HTTP 請求送到後端?
  ├─ 是 → Cookie (設定 HttpOnly、Secure、SameSite)
  └─ 否 → 資料量 > 5MB 或需索引查詢?
          ├─ 是 → IndexedDB (配合 idb/Dexie)
          └─ 否 → 需跨分頁共享且持久化?
                  ├─ 是 → localStorage
                  └─ 否 → sessionStorage (分頁隔離、臨時狀態)

安全最佳實踐

  1. 敏感 Token 僅存 HttpOnly Cookie:防 XSS 竊取;localStorage 易受 XSS 攻擊。
  2. 設定 SameSite=Lax/Strict:防 CSRF。
  3. 避免在 localStorage 存放 PII(個人識別資訊):未加密易洩露。
  4. 定期清理過期資料:localStorage 無 TTL,需自行實作掃描清理。
  5. 隱私模式/無痕模式:儲存可能失效或即時清除,代碼需 try-catch 包裹。

總結

現代 Web 應用通常採用「HttpOnly Cookie 存 Token + localStorage 存非敏感偏好/快取 + IndexedDB 存大量離線資料」的分層策略。理解各機制特性與限制,才能打造安全、高效、可維護的本地儲存架構。

copyright © 萬盛學電腦網 all rights reserved