Cookie 是伺服器與客戶端維持狀態的經典機制。雖有 `localStorage`/`sessionStorage`/`IndexedDB`,但 Cookie 仍是**自動隨請求發送**給伺服器的唯一儲存方式,適用於身份驗證 Token、追蹤 ID 等。
name=value; expires=DATE; path=PATH; domain=DOMAIN; secure; samesite=LAX|STRICT|NONE
| 屬性 | 說明 |
|---|---|
Expires/Max-Age | 過期時間。無則為 Session Cookie (瀏覽器關閉失效)。`Max-Age` 以秒為單位較精確。 |
Path | 生效路徑前綴。預設為設定頁面路徑。`/` 代表全域名。 |
Domain | 生效域名。預設為當前主機名 (不含子域)。設定 `.example.com` 含所有子域。 |
Secure | 僅 HTTPS 傳輸。現代最佳實踐**必須加上**。 |
SameSite | CSRF 防護:`Strict`(完全禁止跨站)、`Lax`(預設、允許連結導航)、`None`(跨站發送,**需 Secure**)。 |
HttpOnly | **僅伺服器可設定**。防止 XSS 竊取 JS 讀取。認證 Token 必須設定。 |
// 設定
function setCookie(name, value, days = 30, options = {}) {
const expires = new Date(Date.now() + days * 864e5).toUTCString();
const parts = [
`${encodeURIComponent(name)}=${encodeURIComponent(value)}`,
`expires=${expires}`,
`path=${options.path || '/'}`,
options.domain ? `domain=${options.domain}` : '',
options.secure ? 'secure' : '',
`samesite=${options.sameSite || 'Lax'}`
].filter(Boolean);
document.cookie = parts.join('; ');
}
// 讀取
function getCookie(name) {
const cookies = document.cookie.split('; ');
for (const cookie of cookies) {
const [key, ...valParts] = cookie.split('=');
if (key === name) return decodeURIComponent(valParts.join('='));
}
return null;
}
// 刪除 (設定過期過去時間)
function deleteCookie(name, options = {}) {
setCookie(name, '', -1, options);
}
<script>
// 登入成功後
setCookie('auth_token', 'jwt_token_here', 7, {
secure: true,
sameSite: 'Lax' // 或 'Strict' 視安全需求
});
// 每次請求自動攜帶 Cookie (同源)
// 伺服器端讀取 Cookie 驗證身份
// 登出
deleteCookie('auth_token', { path: '/', secure: true, sameSite: 'Lax' });
</script>
| 儲存機制 | 容量 | 自動隨請求發送 | 適用場景 |
|---|---|---|---|
| Cookie | 4KB | ✅ 是 | 身份驗證、CSRF Token、Server-side Session ID |
| localStorage | 5-10MB | ❌ 否 | 用戶偏好、快取資料、離線資料 |
| sessionStorage | 5-10MB | ❌ 否 | 單分頁暫時狀態、表單草稿 |
| IndexedDB | 數百 MB | ❌ 否 | 大量結構化資料、離線資料庫 |
Cookie 仍是 Server-Client 狀態同步關鍵。前端操作請封裝工具函式處理編碼/屬性。敏感資料**務必由伺服器設定 `HttpOnly`**,前端不可讀寫。客戶端狀態優先用 `localStorage`/`IndexedDB`。