jQuery Cookie 是最經典的 Cookie 操作插件,API 簡潔、鏈式調用、自動編碼解碼。本文匯總所有配置選項、實戰代碼片段、中文亂碼解決、檢測 Cookie 可用性、完整調用模板。
<script src="jquery.min.js"></script>
<script src="jquery.cookie.js"></script>
| 操作 | 語法 | 返回值 |
|---|---|---|
| 讀取 | $.cookie(name) | 字符串值 / null |
| 寫入(會話級) | $.cookie(name, value) | undefined |
| 寫入(持久化) | $.cookie(name, value, {expires: 7}) | undefined |
| 刪除 | $.cookie(name, null, options) | undefined |
$.cookie('name', 'value', {
expires: 7, // Number(天) | Date 對象
path: '/', // String,默認當前頁路徑
domain: 'example.com',// String,默認當前域
secure: true, // Boolean,僅 HTTPS
raw: false // Boolean,true 關閉 encodeURIComponent
});
// 寫入
$.cookie('theme', 'dark', { expires: 30, path: '/' });
// 讀取
var theme = $.cookie('theme'); // "dark" 或 null
// 刪除(需帶上寫入時的 path/domain)
$.cookie('theme', null, { path: '/', domain: 'example.com' });
// 會話級:關閉瀏覽器失效
$.cookie('temp_flag', '1');
// 持久化:30 天
$.cookie('persist_flag', '1', { expires: 30, path: '/' });
// 寫入中文
$.cookie('username', '張三'); // 內部自動 encodeURIComponent -> "%E5%BC%B5%E4%B8%89"
// 讀取自動解碼
var name = $.cookie('username'); // "張三"
// 若後端手動設置 Cookie 未編碼,導致讀取亂碼
// 解決:關閉插件自動編碼
$.cookie.raw = true; // 全局關閉
// 或單次關閉
$.cookie('raw_cookie', '已編碼值', { raw: true });
var date = new Date();
date.setTime(date.getTime() + 30 * 60 * 1000); // 30 分鐘
$.cookie('short_live', 'data', { expires: date, path: '/' });
function areCookiesEnabled() {
var testKey = 'cookie_test_' + Date.now();
var exp = new Date(Date.now() + 60000); // 1 分鐘
document.cookie = testKey + '=1; expires=' + exp.toGMTString() + '; path=/';
var enabled = document.cookie.indexOf(testKey + '=') !== -1;
// 清理測試 Cookie
document.cookie = testKey + '=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/';
return enabled;
}
$(function () {
if (!areCookiesEnabled()) {
alert('請啟用 Cookie 以獲得完整功能');
}
});
// 寫入完整配置
$.cookie('key', 'value', {
expires: 30, // 30 天
path: '/', // 全站
domain: '.example.com',// 跨子域
secure: true, // 僅 HTTPS
raw: false // 自動編碼中文
});
// 刪除完整配置
$.cookie('key', null, {
path: '/',
domain: '.example.com'
});
jQuery Cookie 仍是維護舊專案、快速原型的利器;新專案優先考慮現代存儲方案。