萬盛學電腦網

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

JavaScript Cookie 完整指南:原理、操作與最佳實踐

什麼是 Cookie?

Cookie 是網站存儲在用戶瀏覽器端的小型文本數據(通常 ≤ 4KB),隨每次 HTTP 請求自動發送給同域服務器。它是 HTTP 無狀態協議下實現「有狀態」會話的關鍵機制。

Cookie 核心特性

特性說明
域綁定只屬於設置它的域(及子域,視配置),跨域不可訪問
自動攜帶同域請求自動在 HTTP Header 中發送(Cookie:)
過期控制可設置過期時間,過期自動刪除
大小限制單個 Cookie ≤ 4KB,每域通常 ≤ 50-180 個
存儲位置用戶硬盤(瀏覽器管理),不同瀏覽器隔離存儲

典型應用場景

  1. 會話管理: 存儲 Session ID,實現登錄態保持、購物車等
  2. 個性化: 記住用戶偏好(主題、語言、地區)
  3. 追蹤分析: 記錄用戶行為、訪問路徑(需遵循隱私法規)
  4. 跨頁面數據傳遞: 同域不同頁面間共享小數據

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/NoneSameSite=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

特性CookielocalStoragesessionStorage
容量~4KB~5-10MB~5-10MB
隨請求發送是否否
過期機制手動設置永久(手動清除)標籤頁關閉清除
跨標籤頁同步是是(storage 事件)否
適用場景會話標識、服務端需讀取的數據客戶端持久化數據、緩存臨時會話數據、表單草稿

總結

Cookie 是 Web 狀態管理的基石,但原生 API 簡陋、安全風險高。現代開發建議:

  1. 服務端設置關鍵 Cookie(HttpOnly, Secure, SameSite)
  2. 客戶端封裝工具函數統一操作
  3. 非敏感、大量、純客戶端數據改用 localStorage/IndexedDB
  4. 遵循 GDPR 等隱私法規,獲取用戶同意
copyright © 萬盛學電腦網 all rights reserved