萬盛學電腦網

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

JavaScript Cookie 創建、讀取、刪除與最佳實踐完整指南

前言

Cookie 是瀏覽器存儲少量數據(≤4KB)的經典機制,隨每次 HTTP 請求自動發送。本文提供標準化的 Cookie 操作庫,覆蓋設置、讀取、刪除、選項配置、安全屬性、現代替代方案。

標準 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' });

Cookie 關鍵屬性詳解

屬性說明安全建議
Expires/Max-Age過期時間。Expires=GMT 日期;Max-Age=秒數(優先級更高)敏感數據設置較短過期(如 30 分鐘)
Path生效路徑。/ 為全站盡量縮小範圍(如 /app/)
Domain生效域名。默認當前域,設置 .example.com 共享子域避免設置過寬域名
Secure僅 HTTPS 傳輸生產環境必須開啟
HttpOnlyJS 無法讀取(需服務端設置)敏感 Cookie 必須開啟,防 XSS 竊取
SameSite跨站請求攜帶策略:Strict/Lax/NoneLax 平衡體驗與安全;None 需配合 Secure

安全最佳實踐

  1. 敏感數據(Token、SessionID):服務端設置 HttpOnly; Secure; SameSite=Strict,前端 JS 不可讀寫。
  2. 非敏感偏好設置(主題、語言):前端 JS 讀寫,SameSite=Lax。
  3. 防 CSRF:雙重 Cookie 模式(CSRF Token 在 Cookie + Header 中雙重驗證)或 SameSite=Strict/Lax。
  4. 不存儲大數據:單 Cookie ≤4KB,總數每域 ≤20-50 個,超量用 localStorage/IndexedDB。
  5. 定期清理:登出時調用 remove() 清除所有業務 Cookie。

現代替代方案對比

存儲容量隨請求發送API適用場景
Cookie4KB是同步身份認證、CSRF Token、服務端需讀取的少量數據
localStorage5-10MB否同步持久化緩存、用戶偏好、離線數據
sessionStorage5-10MB否同步會話級臨時數據、表單草稿、標籤頁隔離
IndexedDB數百 MB否異步大量結構化數據、離線應用、客戶端搜索

總結

Cookie 是「隨請求自動攜帶」的獨特存儲。現代架構:認證用 HttpOnly Cookie + SameSite,業務數據用 localStorage/IndexedDB。封裝統一 CookieUtil,統一編碼、過期計算、安全屬性,避免手寫字符串拼接導致的 Bug。

copyright © 萬盛學電腦網 all rights reserved