萬盛學電腦網

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

jQuery Cookie 插件使用詳解:讀寫、刪除、路徑與過期設定

jQuery Cookie 是一款輕量級插件,封裝了原生 document.cookie 的繁瑣操作,提供鏈式語法進行 Cookie 的讀取、寫入、刪除,並支援過期時間、路徑、域、安全傳輸等屬性配置。本文詳細說明其用法與常見陷阱。

1. 引用準備

<script src="jquery.min.js"></script>
<script src="jquery.cookie.js"></script>

插件官網:github.com/carhartl/jquery-cookie(原 jquery.com 已歸檔)。

2. 核心 API

操作語法說明
寫入/更新$.cookie(name, value[, options])options 可含 expires, path, domain, secure, raw
讀取$.cookie(name)返回字串值,不存在回傳 null
刪除$.cookie(name, null[, options])需與寫入時的 path、domain 一致才能刪除

3. 實戰範例

3.1 會話級 Cookie(瀏覽器關閉即失效)

$.cookie('user_token', 'abc123'); // 無 expires 參數

3.2 持久化 Cookie(指定天數)

$.cookie('remember_me', 'true', { expires: 7 }); // 7 天后過期

3.3 指定路徑、域、安全傳輸

$.cookie('session_id', 'xyz', {
    expires: 30,
    path: '/',           // 整站可讀
    domain: 'example.com', // 跨子域共享
    secure: true,        // 僅 HTTPS 傳輸
    raw: true            // 關閉自動 encodeURIComponent
});

3.4 讀取與判斷

var token = $.cookie('user_token');
if (token) {
    console.log('已登入:' + token);
} else {
    console.log('未登入或 Cookie 已過期');
}

3.5 刪除 Cookie

// 必須帶上寫入時相同的 path/domain
$.cookie('user_token', null, { path: '/', domain: 'example.com' });

4. 進階選項詳解

  • expires:Number(天數)或 Date 物件。省略則為會話級。
  • path:Cookie 生效路徑。預設為建立頁面路徑,跨目錄讀取需設為 '/'。
  • domain:共享域。設為 '.example.com' 可讓所有子域讀取(注意前綴點)。
  • secure:true 時僅 HTTPS 傳送,防止中間人竊取。
  • raw:true 時不自動 encodeURIComponent,需自行處理特殊字元。

5. 常見問題與解決方案

  1. 刪除無效:刪除時未帶上原 path/domain,導致瀏覽器視為不同 Cookie。解決:刪除時完整複製寫入時的 options。
  2. 中文亂碼:預設啟用 encodeURIComponent,讀取時自動解碼。若後端解碼方式不一致,可設 raw: true 自行處理。
  3. 跨域共享:主域 a.example.com 寫入 domain: '.example.com',b.example.com 即可讀取。但須注意同源策略限制,僅限同主域下的子域。
  4. 大小限制:單個 Cookie ≤ 4KB,總數每域約 20~50 個,超量會被瀏覽器忽略。

6. 原生 JS 替代方案(無依賴)

現代瀏覽器可使用 document.cookie 封裝輕量工具函數,或改用 localStorage/sessionStorage 存儲非敏感、大量數據,避免每次 HTTP 請求攜帶 Cookie 開銷。

掌握 jQuery Cookie 插件的核心參數與坑點,能讓前端狀態管理更輕鬆可控。

copyright © 萬盛學電腦網 all rights reserved