萬盛學電腦網

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

JavaScript 獲取 Cookie 過期時間的變通方案:雙 Cookie 協作模式

核心限制:瀏覽器不暴露 Cookie 過期時間

document.cookie 僅返回 `name=value` 鍵值對,**不包含 expires、domain、path、HttpOnly、Secure、SameSite** 等屬性。服務端 (ASP.NET/PHP/Java) 讀取請求頭 `Cookie` 同樣無過期信息。

變通方案:雙 Cookie 協作 (前端可控)

// 設置業務 Cookie 時,同步設置一個「過期時間記錄 Cookie」
function setCookieWithExpiry(name, value, maxAgeSeconds) {
  var expiryDate = new Date(Date.now() + maxAgeSeconds * 1000);
  var expiryStr = expiryDate.toUTCString(); // GMT 格式
  var expiryISO = expiryDate.toISOString(); // ISO 8601,便於 JS 解析

  // 1. 設置業務 Cookie
  document.cookie = name + '=' + encodeURIComponent(value) 
    + '; max-age=' + maxAgeSeconds 
    + '; path=/; secure; samesite=Lax';

  // 2. 設置元數據 Cookie:名稱約定為 __exp_ + 業務名
  // value 存 ISO 字符串,同樣設置相同屬性確保同步過期
  document.cookie = '__exp_' + name + '=' + encodeURIComponent(expiryISO)
    + '; max-age=' + maxAgeSeconds
    + '; path=/; secure; samesite=Lax';
}

// 讀取過期時間
function getCookieExpiry(name) {
  var metaName = '__exp_' + name;
  var cookies = document.cookie.split('; ');
  for (var i = 0; i < cookies.length; i++) {
    var parts = cookies[i].split('=');
    if (parts[0] === metaName) {
      try {
        return new Date(decodeURIComponent(parts[1]));
      } catch (e) {
        return null;
      }
    }
  }
  return null; // 無元數據 Cookie (可能是舊版本設置、或被手動刪除)
}

// 判斷是否即將過期 (如提前 5 分鐘提醒刷新)
function isCookieExpiringSoon(name, thresholdMinutes) {
  var expiry = getCookieExpiry(name);
  if (!expiry) return false; // 無法判斷,視為不即將過期
  var now = new Date();
  var diffMs = expiry - now;
  return diffMs > 0 && diffMs < thresholdMinutes * 60 * 1000;
}

// 使用
setCookieWithExpiry('token', 'abc123', 3600); // 1 小時
console.log('過期時間:', getCookieExpiry('token'));
console.log('5 分鐘內過期?', isCookieExpiringSoon('token', 5));

方案優缺點分析

優點缺點
純前端實現,無需後端配合雙倍 Cookie 數量,受單域 180 個限制影響
同步過期:業務 Cookie 刪除/過期,元數據自動跟著消失用戶手動刪除業務 Cookie 但保留元數據會導致不一致 (極少見)
可存儲任意元數據 (創建時間、版本、簽名等)增加請求頭大小 (每次 HTTP 請求攜帶)
支持精確到毫秒的過期判斷依賴客戶端時間,用戶修改系統時間會誤判

進階:統一 Cookie 管理器 (自動掛載元數據)

class CookieManager {
  constructor(defaultOptions = {}) {
    this.defaults = {
      path: '/',
      domain: '',
      secure: location.protocol === 'https:',
      sameSite: 'Lax',
      ...defaultOptions
    };
    this.metaPrefix = '__meta_';
  }

  _buildString(name, value, options) {
    var opts = { ...this.defaults, ...options };
    var parts = [name + '=' + encodeURIComponent(value)];
    if (opts.maxAge != null) parts.push('max-age=' + opts.maxAge);
    if (opts.expires) parts.push('expires=' + opts.expires.toUTCString());
    if (opts.path) parts.push('path=' + opts.path);
    if (opts.domain) parts.push('domain=' + opts.domain);
    if (opts.secure) parts.push('secure');
    if (opts.sameSite) parts.push('samesite=' + opts.sameSite);
    return parts.join('; ');
  }

  set(name, value, options) {
    var opts = { ...this.defaults, ...options };
    // 設置主 Cookie
    document.cookie = this._buildString(name, value, opts);
    // 自動設置元數據 Cookie (存儲完整選項供讀取)
    var meta = {
      created: Date.now(),
      expires: opts.maxAge ? Date.now() + opts.maxAge * 1000 : (opts.expires ? opts.expires.getTime() : null),
      options: opts // 可選:存儲原始配置
    };
    document.cookie = this._buildString(this.metaPrefix + name, JSON.stringify(meta), opts);
  }

  get(name) {
    var cookies = document.cookie.split('; ');
    for (var i = 0; i < cookies.length; i++) {
      var [k, v] = cookies[i].split('=');
      if (k === name) return decodeURIComponent(v);
    }
    return null;
  }

  getMeta(name) {
    var val = this.get(this.metaPrefix + name);
    try { return val ? JSON.parse(val) : null; } catch (e) { return null; }
  }

  getExpiry(name) {
    var meta = this.getMeta(name);
    return meta && meta.expires ? new Date(meta.expires) : null;
  }

  isExpiringSoon(name, thresholdMs) {
    var expiry = this.getExpiry(name);
    if (!expiry) return false;
    var diff = expiry - Date.now();
    return diff > 0 && diff < (thresholdMs || 5 * 60 * 1000);
  }

  remove(name, options) {
    var opts = { ...this.defaults, ...options, maxAge: 0 };
    document.cookie = this._buildString(name, '', opts);
    document.cookie = this._buildString(this.metaPrefix + name, '', opts);
  }

  has(name) {
    return this.get(name) !== null;
  }
}

// 單例
var cookies = new CookieManager({ path: '/', domain: '.example.com' });
cookies.set('user', 'Tom', { maxAge: 3600 });
console.log('過期:', cookies.getExpiry('user'));
console.log('即將過期:', cookies.isExpiringSoon('user', 10 * 60 * 1000));

服務端同步方案 (更可靠)

若後端可控,**推薦在設置 Cookie 的響應頭中攜帶自定義頭返回過期時間**,前端讀取響應頭緩存:

// 後端 (Node.js/Express 示例)
res.cookie('token', 'abc', { maxAge: 3600000, httpOnly: true });
res.set('X-Cookie-Expires-Token', new Date(Date.now() + 3600000).toISOString());

// 前端攔截攔截器 (Axios/Fetch)
axios.interceptors.response.use(function (response) {
  var expiresHeader = response.headers['x-cookie-expires-token'];
  if (expiresHeader) {
    sessionStorage.setItem('cookie_exp_token', expiresHeader);
  }
  return response;
});

function getTokenExpiry() {
  var str = sessionStorage.getItem('cookie_exp_token');
  return str ? new Date(str) : null;
}

優勢:不增加 Cookie 數量、HttpOnly Cookie 也能獲取過期時間、服務端時間權威、無客戶端時間偏差風險。

總結

瀏覽器不暴露 Cookie 過期時間是安全設計。前端變通方案是**雙 Cookie 協作** (業務 + 元數據) 或**服務端響應頭透傳**。前者純前端實現但增加 Cookie 數量與請求體積;後者更乾淨、支持 HttpOnly、時間權威。建議:新項目優先用服務端響應頭方案,老項目無法改後端時用雙 Cookie 方案並封裝 CookieManager 統一管理。

copyright © 萬盛學電腦網 all rights reserved