Cookie 是瀏覽器存儲少量數據(≤4KB)的經典機制,隨每次 HTTP 請求自動發送。本文提供標準化的 Cookie 操作庫,覆蓋設置、讀取、刪除、選項配置、安全屬性、現代替代方案。
const CookieUtil = {
// 設置 Cookie
set: function(name, value, options = {}) {
options = Object.assign({
expires: 30, // 過期天數
path: '/', // 路徑
domain: '', // 域名(默認當前域)
secure: false, // 僅 HTTPS
sameSite: 'Lax' // SameSite 策略:Strict/Lax/None
}, options);
var expires = '';
if (options.expires !== null) {
var date = new Date();
date.setTime(date.getTime() + (options.expires * 24 * 60 * 60 * 1000));
expires = '; expires=' + date.toUTCString();
}
var domain = options.domain ? '; domain=' + options.domain : '';
var secure = options.secure ? '; secure' : '';
var sameSite = '; SameSite=' + options.sameSite;
document.cookie = encodeURIComponent(name) + '=' + encodeURIComponent(value)
+ expires + '; path=' + options.path + domain + secure + sameSite;
},
// 讀取 Cookie
get: function(name) {
var nameEQ = encodeURIComponent(name) + '=';
var cookies = document.cookie.split(';');
for (var i = 0; i < cookies.length; i++) {
var cookie = cookies[i].trim();
if (cookie.indexOf(nameEQ) === 0) {
return decodeURIComponent(cookie.substring(nameEQ.length));
}
}
return null;
},
// 刪除 Cookie
remove: function(name, options = {}) {
// 設置過期時間為過去
this.set(name, '', Object.assign({}, options, { expires: -1 }));
},
// 獲取所有 Cookie 對象
getAll: function() {
var result = {};
var cookies = document.cookie.split(';');
for (var i = 0; i < cookies.length; i++) {
var cookie = cookies[i].trim();
var eqIdx = cookie.indexOf('=');
if (eqIdx > 0) {
var name = decodeURIComponent(cookie.substring(0, eqIdx));
var value = decodeURIComponent(cookie.substring(eqIdx + 1));
result[name] = value;
}
}
return result;
}
};
// 設置:30 天過期、全站可用、HTTPS 傳輸、Lax 同站策略
CookieUtil.set('username', '張三', { expires: 30, secure: location.protocol === 'https:' });
// 讀取
var username = CookieUtil.get('username'); // "張三" 或 null
// 刪除
CookieUtil.remove('username', { path: '/' }); // 必須指定相同 path
// 會話級 Cookie(關閉瀏覽器失效)
CookieUtil.set('session_token', 'abc123', { expires: null }); // 不設置 expires
// 子域共享(.example.com 及所有子域)
CookieUtil.set('global_token', 'xyz', { domain: '.example.com' });
| 屬性 | 說明 | 安全建議 |
|---|---|---|
| Expires/Max-Age | 過期時間。Expires=GMT 日期;Max-Age=秒數(優先級更高) | 敏感數據設置較短過期(如 30 分鐘) |
| Path | 生效路徑。/ 為全站 | 盡量縮小範圍(如 /app/) |
| Domain | 生效域名。默認當前域,設置 .example.com 共享子域 | 避免設置過寬域名 |
| Secure | 僅 HTTPS 傳輸 | 生產環境必須開啟 |
| HttpOnly | JS 無法讀取(需服務端設置) | 敏感 Cookie 必須開啟,防 XSS 竊取 |
| SameSite | 跨站請求攜帶策略:Strict/Lax/None | Lax 平衡體驗與安全;None 需配合 Secure |
HttpOnly; Secure; SameSite=Strict,前端 JS 不可讀寫。SameSite=Lax。remove() 清除所有業務 Cookie。| 存儲 | 容量 | 隨請求發送 | API | 適用場景 |
|---|---|---|---|---|
| Cookie | 4KB | 是 | 同步 | 身份認證、CSRF Token、服務端需讀取的少量數據 |
| localStorage | 5-10MB | 否 | 同步 | 持久化緩存、用戶偏好、離線數據 |
| sessionStorage | 5-10MB | 否 | 同步 | 會話級臨時數據、表單草稿、標籤頁隔離 |
| IndexedDB | 數百 MB | 否 | 異步 | 大量結構化數據、離線應用、客戶端搜索 |
Cookie 是「隨請求自動攜帶」的獨特存儲。現代架構:認證用 HttpOnly Cookie + SameSite,業務數據用 localStorage/IndexedDB。封裝統一 CookieUtil,統一編碼、過期計算、安全屬性,避免手寫字符串拼接導致的 Bug。