萬盛學電腦網

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

JavaScript Cookie 完整指南:建立、讀取、刪除、屬性與現代替代方案

前言

Cookie 是伺服器與客戶端維持狀態的經典機制。雖有 `localStorage`/`sessionStorage`/`IndexedDB`,但 Cookie 仍是**自動隨請求發送**給伺服器的唯一儲存方式,適用於身份驗證 Token、追蹤 ID 等。

Cookie 屬性結構

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 傳輸。現代最佳實踐**必須加上**。
SameSiteCSRF 防護:`Strict`(完全禁止跨站)、`Lax`(預設、允許連結導航)、`None`(跨站發送,**需 Secure**)。
HttpOnly**僅伺服器可設定**。防止 XSS 竊取 JS 讀取。認證 Token 必須設定。

原生 JS 操作 Cookie

// 設定
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>

現代替代方案比較

儲存機制容量自動隨請求發送適用場景
Cookie4KB✅ 是身份驗證、CSRF Token、Server-side Session ID
localStorage5-10MB❌ 否用戶偏好、快取資料、離線資料
sessionStorage5-10MB❌ 否單分頁暫時狀態、表單草稿
IndexedDB數百 MB❌ 否大量結構化資料、離線資料庫

安全最佳實踐

  • **敏感 Token 必須 `HttpOnly` + `Secure` + `SameSite=Strict/Lax`**。
  • 避免在 Cookie 存放大量資料 (影響請求標頭大小、效能)。
  • 子域共享 Cookie 時謹慎設定 `Domain`,評估安全風險。
  • 定期輪換 Token,實作 Refresh Token 機制。

總結

Cookie 仍是 Server-Client 狀態同步關鍵。前端操作請封裝工具函式處理編碼/屬性。敏感資料**務必由伺服器設定 `HttpOnly`**,前端不可讀寫。客戶端狀態優先用 `localStorage`/`IndexedDB`。

copyright © 萬盛學電腦網 all rights reserved