萬盛學電腦網

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

HTML5 LocalStorage 實戰指南:從基礎 API 到生產級封裝方案

Cookie 4KB 限制、隨請求自動發送、汙染 HTTP 流量,移動端項目中已不再適合作為業務數據存儲。LocalStorage(~5MB、不隨請求發送、持久化)成為首選,但需妥善處理容量、隱私模式、性能、過期、爬蟲不可讀等坑點。

核心 API 速查

方法/屬性說明
localStorage.setItem(key, value)存儲字符串鍵值對
localStorage.getItem(key)讀取值,不存在返回 null
localStorage.removeItem(key)刪除指定鍵
localStorage.clear()清空當前域下所有數據
localStorage.key(index)獲取指定索引的鍵名
localStorage.length鍵值對數量

注意:只能存字符串,物件需 JSON.stringify/parse。

SessionStorage vs LocalStorage

  • sessionStorage:會話級,標籤頁關閉即銷毀,適合臨時表單、單次流程狀態。
  • localStorage:持久級,跨會話保留,適合用戶偏好、緩存數據、Token 等。

生產級封裝核心需求

  1. 統一過期機制:每條數據攜帶 expireTime,讀取時自動清理過期項。
  2. 容量滿時淘汰策略:優先刪除最近將過期項(LRU+TTL 混合),而非暴力 clear()。
  3. 鍵值索引表:維護 SYSTEM_KEY_TIMEOUT_MAP 映射表,避免遍歷全庫檢查過期。
  4. 異常兜底:捕獲 QuotaExceededError,執行淘汰後重試。
  5. 簽名機制:同一 Key 不同參數(如城市切換)通過 sign 區分緩存版本。
  6. 序列化存儲結構:{value, inDate, timeout, sign}

參考實現(核心邏輯節選)

define([], function () {
  var Storage = _.inherit({
    propertys: function () {
      this.sProxy = window.localStorage;
      this.defaultLifeTime = 2592000000; // 30天
      this.keyCache = 'SYSTEM_KEY_TIMEOUT_MAP';
      this.removeNum = 5;
    },
    set: function (key, value, timeout, sign) {
      var entity = this.buildStorageObj(value, Date.now(), timeout || Date.now()+this.defaultLifeTime, sign);
      try {
        this.sProxy.setItem(key, JSON.stringify(entity));
        this.setKeyCache(key, entity.timeout);
        return true;
      } catch (e) {
        if (e.name === 'QuotaExceededError') {
          if (!this.removeLastCache()) throw '存儲量過大';
          return this.set(key, value, timeout, sign); // 遞歸重試
        }
        return false;
      }
    },
    removeOverdueCache: function () { /* 遍歷 keyCache 清理過期 */ },
    removeLastCache: function () { /* 按 timeout 排序刪除 removeNum 條 */ },
    // ... get、buildStorageObj、setKeyCache 等輔助方法
  });
  return new Storage();
});

實際業務場景映射

場景存儲策略過期/更新
搜索頁出發/到達城市localStorage,Key 固定用戶主動修改時更新,長期保留
城市列表數據(大數據)localStorage,分頁/分字母存儲服務端推送版本號,版本變更時標記過期
用戶 Token/登錄態localStorage + 內存雙寫登出/過期時清除,攔截器統一處理
表單草稿sessionStorage提交成功清除,關閉標籤自動銷毀

避坑指南

  • 隱私模式下 localStorage 讀寫拋異常 → try-catch 降級內存存儲。
  • 數據量大(>1MB)讀寫卡頓 → 分片存儲、Web Worker 異步處理、或改用 IndexedDB。
  • SEO 依賴內容不可用 LocalStorage → 關鍵內容仍需 SSR/URL 參數傳遞。
  • 同域不同子項目 Key 衝突 → 統一加項目前綴(如 jd_mall_city_list)。
copyright © 萬盛學電腦網 all rights reserved