什麼是 Cookie?
Cookie 是網站存儲在用戶瀏覽器端的小型文本數據(通常 ≤ 4KB),隨每次 HTTP 請求自動發送給同域服務器。它是 HTTP 無狀態協議下實現「有狀態」會話的關鍵機制。
Cookie 核心特性
| 特性 | 說明 |
| 域綁定 | 只屬於設置它的域(及子域,視配置),跨域不可訪問 |
| 自動攜帶 | 同域請求自動在 HTTP Header 中發送(Cookie:) |
| 過期控制 | 可設置過期時間,過期自動刪除 |
| 大小限制 | 單個 Cookie ≤ 4KB,每域通常 ≤ 50-180 個 |
| 存儲位置 | 用戶硬盤(瀏覽器管理),不同瀏覽器隔離存儲 |
典型應用場景
- 會話管理: 存儲 Session ID,實現登錄態保持、購物車等
- 個性化: 記住用戶偏好(主題、語言、地區)
- 追蹤分析: 記錄用戶行為、訪問路徑(需遵循隱私法規)
- 跨頁面數據傳遞: 同域不同頁面間共享小數據
Cookie 結構與屬性
document.cookie = "name=value; expires=date; path=path; domain=domain; secure; SameSite=Strict/Lax/None"
| 屬性 | 說明 | 示例 |
name=value | 必需,鍵值對,值需編碼 | userId=828 |
expires | 過期時間(GMT 格式),缺省為會話級(關閉瀏覽器失效) | expires=Fri, 31 Dec 2099 23:59:59 GMT |
max-age | 相對秒數(優先於 expires),0 即刪除 | max-age=3600(1小時) |
path | 生效路徑前綴,默認當前路徑 | path=/(全站可用) |
domain | 生效域,默認當前域,可設置父域實現子域共享 | domain=.example.com |
secure | 僅 HTTPS 傳輸 | secure(無值) |
SameSite | 跨站請求攜帶策略:Strict/Lax/None | SameSite=Lax |
JavaScript 操作 Cookie:原生 API 痛點
document.cookie 既是 getter 也是 setter,但行為奇特:
- 寫入:
document.cookie = "a=1" — 只添加/修改單個 Cookie
- 讀取:
document.cookie — 返回所有 Cookie 字符串(以 ; 分隔)
- 無原生: 獲取單個、刪除、判斷存在性等方法
編碼處理:escape/unescape(已棄用)→ encodeURIComponent/decodeURIComponent
// 寫入時編碼
document.cookie = "msg=" + encodeURIComponent("I love JS");
// 實際存儲:msg=I%20love%20JS
// 讀取後解碼
var val = decodeURIComponent(getCookie("msg")); // "I love JS"
封裝實用工具函數
設置 Cookie(支持完整屬性)
/**
* 設置 Cookie
* @param {string} name - 鍵名
* @param {string} value - 值(自動編碼)
* @param {Object} options - 可選配置
* {number} expires - 過期小時數
* {string} path - 路徑
* {string} domain - 域
* {boolean} secure - 僅 HTTPS
* {string} sameSite - 'Strict'|'Lax'|'None'
*/
function setCookie(name, value, options = {}) {
var str = name + "=" + encodeURIComponent(value);
if (options.expires) {
var date = new Date();
date.setTime(date.getTime() + options.expires * 3600 * 1000);
str += "; expires=" + date.toGMTString();
}
if (options.path) str += "; path=" + options.path;
if (options.domain) str += "; domain=" + options.domain;
if (options.secure) str += "; secure";
if (options.sameSite) str += "; SameSite=" + options.sameSite;
document.cookie = str;
}
獲取 Cookie(解析字符串)
function getCookie(name) {
var cookies = document.cookie.split("; ");
for (var i = 0; i < cookies.length; i++) {
var parts = cookies[i].split("=");
if (parts[0] === name) {
return decodeURIComponent(parts[1]);
}
}
return null;
}
刪除 Cookie(設置過期時間為過去)
function deleteCookie(name, path, domain) {
var value = getCookie(name);
if (value !== null) {
var opts = { expires: -1/3600 }; // 1秒前過期
if (path) opts.path = path;
if (domain) opts.domain = domain;
setCookie(name, value, opts);
}
}
完整封裝庫模式(推薦生產使用)
const Cookie = {
set(name, value, options = {}) {
// ... 同上
},
get(name) {
// ... 同上
},
remove(name, path, domain) {
// ... 同上
},
getAll() {
return document.cookie.split("; ").reduce((acc, cookie) => {
const [key, ...valParts] = cookie.split("=");
acc[key] = decodeURIComponent(valParts.join("="));
return acc;
}, {});
},
has(name) {
return this.get(name) !== null;
}
};
// 使用示例
Cookie.set("theme", "dark", { expires: 24*30, path: "/", sameSite: "Lax" });
console.log(Cookie.get("theme")); // "dark"
Cookie.remove("theme");
安全與隱私最佳實踐
| 風險 | 防護措施 |
| XSS 竊取 Cookie | 設置 HttpOnly(需服務端設置)、CSP 頭、輸出編碼 |
| CSRF 攻擊 | SameSite=Strict/Lax、CSRF Token、雙重驗證 Cookie |
| 敏感信息洩露 | 不存儲密碼、Token 等敏感值;必須加密存儲 |
| 用戶禁用/清除 Cookie | 提供降級方案(localStorage、IndexedDB、URL 參數) |
| 跨域共享風險 | 謹慎設置 domain、SameSite=None; Secure 需 HTTPS |
現代替代方案:Web Storage API
| 特性 | Cookie | localStorage | sessionStorage |
| 容量 | ~4KB | ~5-10MB | ~5-10MB |
| 隨請求發送 | 是 | 否 | 否 |
| 過期機制 | 手動設置 | 永久(手動清除) | 標籤頁關閉清除 |
| 跨標籤頁同步 | 是 | 是(storage 事件) | 否 |
| 適用場景 | 會話標識、服務端需讀取的數據 | 客戶端持久化數據、緩存 | 臨時會話數據、表單草稿 |
總結
Cookie 是 Web 狀態管理的基石,但原生 API 簡陋、安全風險高。現代開發建議:
- 服務端設置關鍵 Cookie(
HttpOnly, Secure, SameSite)
- 客戶端封裝工具函數統一操作
- 非敏感、大量、純客戶端數據改用
localStorage/IndexedDB
- 遵循 GDPR 等隱私法規,獲取用戶同意