document.cookie 僅返回 `name=value` 鍵值對,**不包含 expires、domain、path、HttpOnly、Secure、SameSite** 等屬性。服務端 (ASP.NET/PHP/Java) 讀取請求頭 `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 請求攜帶) |
| 支持精確到毫秒的過期判斷 | 依賴客戶端時間,用戶修改系統時間會誤判 |
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 統一管理。