萬盛學電腦網

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

JavaScript 基於 Cookie 實現類 localStorage API 存儲類:CookieStorage 完整實現

設計目標

提供與 localStorage/sessionStorage 一致的鍵值存儲接口(getItem/setItem/removeItem/clear/key/length),底層基於 HTTP Cookie 實現,支援過期時間與路徑作用域配置。

完整實現代碼(ES5 風格)

function CookieStorage(maxage, path) {
  // 1. 解析 document.cookie 為鍵值對象
  var cookies = (function() {
    var cookies = {};
    var all = document.cookie;
    if (all === '') return cookies;
    var list = all.split('; ');
    for (var i = 0; i < list.length; i++) {
      var cookie = list[i];
      var p = cookie.indexOf('=');
      var name = cookie.substring(0, p);
      var value = decodeURIComponent(cookie.substring(p + 1));
      cookies[name] = value;
    }
    return cookies;
  })();

  // 2. 維護鍵名數組(保證順序與 length)
  var keys = [];
  for (var k in cookies) keys.push(k);

  // 3. 公開 API
  this.length = keys.length;

  this.key = function(n) {
    return (n < 0 || n >= keys.length) ? null : keys[n];
  };

  this.getItem = function(name) {
    return cookies[name] || null;
  };

  this.setItem = function(key, value) {
    if (!(key in cookies)) {
      keys.push(key);
      this.length++;
    }
    cookies[key] = value;
    var cookie = key + '=' + encodeURIComponent(value);
    if (maxage) cookie += '; max-age=' + maxage;
    if (path) cookie += '; path=' + path;
    document.cookie = cookie;
  };

  this.removeItem = function(key) {
    if (!(key in cookies)) return;
    delete cookies[key];
    for (var i = 0; i < keys.length; i++) {
      if (keys[i] === key) { keys.splice(i, 1); break; }
    }
    this.length--;
    document.cookie = key + '=; max-age=0' + (path ? '; path=' + path : '');
  };

  this.clear = function() {
    for (var i = 0; i < keys.length; i++) {
      document.cookie = keys[i] + '=; max-age=0' + (path ? '; path=' + path : '');
    }
    cookies = {}; keys = []; this.length = 0;
  };
}

使用示例

// 實例化:30天過期,全站有效
var store = new CookieStorage(60*60*24*30, '/');

store.setItem('user', 'Alice');
console.log(store.getItem('user')); // "Alice"
console.log(store.length);          // 1
console.log(store.key(0));          // "user"

store.removeItem('user');
console.log(store.getItem('user')); // null

store.setItem('a', 1); store.setItem('b', 2);
store.clear();
console.log(store.length); // 0

與 Web Storage 差異對比

特性CookieStoragelocalStorage
容量~4KB/域~5MB/域
隨請求發送是(每次 HTTP 攜帶)否
過期控制max-age/expires永久(手動清除)
同源策略域+路徑域+協議+端口
API 一致性模擬兼容原生標準

適用場景與避坑指南

  • 適用:需與後端共享數據(如 SSO Token)、極小數據(<4KB)、需自動過期清理
  • 不適用:大量客戶端狀態、敏感數據(無 HttpOnly 保護)、高頻讀寫(每次請求帶上)
  • 避坑:max-age 單位為秒;path 需與寫入時一致才能刪除;編碼用 encodeURIComponent 防特殊字符;同域下多子應用隔離可用 path 前綴區分。
copyright © 萬盛學電腦網 all rights reserved