jQuery Cookie 是一款輕量級插件,封裝了原生 document.cookie 的繁瑣操作,提供鏈式語法進行 Cookie 的讀取、寫入、刪除,並支援過期時間、路徑、域、安全傳輸等屬性配置。本文詳細說明其用法與常見陷阱。
<script src="jquery.min.js"></script>
<script src="jquery.cookie.js"></script>
插件官網:github.com/carhartl/jquery-cookie(原 jquery.com 已歸檔)。
| 操作 | 語法 | 說明 |
|---|---|---|
| 寫入/更新 | $.cookie(name, value[, options]) | options 可含 expires, path, domain, secure, raw |
| 讀取 | $.cookie(name) | 返回字串值,不存在回傳 null |
| 刪除 | $.cookie(name, null[, options]) | 需與寫入時的 path、domain 一致才能刪除 |
$.cookie('user_token', 'abc123'); // 無 expires 參數
$.cookie('remember_me', 'true', { expires: 7 }); // 7 天后過期
$.cookie('session_id', 'xyz', {
expires: 30,
path: '/', // 整站可讀
domain: 'example.com', // 跨子域共享
secure: true, // 僅 HTTPS 傳輸
raw: true // 關閉自動 encodeURIComponent
});
var token = $.cookie('user_token');
if (token) {
console.log('已登入:' + token);
} else {
console.log('未登入或 Cookie 已過期');
}
// 必須帶上寫入時相同的 path/domain
$.cookie('user_token', null, { path: '/', domain: 'example.com' });
Number(天數)或 Date 物件。省略則為會話級。'/'。'.example.com' 可讓所有子域讀取(注意前綴點)。true 時僅 HTTPS 傳送,防止中間人竊取。true 時不自動 encodeURIComponent,需自行處理特殊字元。path/domain,導致瀏覽器視為不同 Cookie。解決:刪除時完整複製寫入時的 options。encodeURIComponent,讀取時自動解碼。若後端解碼方式不一致,可設 raw: true 自行處理。a.example.com 寫入 domain: '.example.com',b.example.com 即可讀取。但須注意同源策略限制,僅限同主域下的子域。現代瀏覽器可使用 document.cookie 封裝輕量工具函數,或改用 localStorage/sessionStorage 存儲非敏感、大量數據,避免每次 HTTP 請求攜帶 Cookie 開銷。
掌握 jQuery Cookie 插件的核心參數與坑點,能讓前端狀態管理更輕鬆可控。