網站若有一部分狀態存在 cookie 裡(最典型的就是「使用者是否已登入」),前端難免要直接讀寫它。原生 document.cookie 能用,但那套字串拼接的 API 實在不好用,而且與 jQuery 的風格格格不入。
與其每次手写一堆字串處理,不如一次把它包成 jQuery 的方法。
$.extend({
cookie: function (name, val) {
if (!val) {
// 取值:用正則從 document.cookie 中撈出對應的片段
var a = document.cookie.match(RegExp("(^|\\s*)" + name + "=([^;]*)(;|$)"));
return a ? decodeURIComponent(a[2]) : null;
} else {
// 賦值
document.cookie = name + "=" + escape(val);
}
},
removeCookie: function (name) {
// 刪除的技巧:把過期時間設為過去
var expires = new Date();
expires.setTime(expires.getTime() - 1);
document.cookie = name + "=;expires=" + expires.toGMTString();
}
});
以登入狀態為例:
// 取值
$.cookie("logonFlag");
// 賦值
$.cookie("logonFlag", true);
// 刪除
$.removeCookie("logonFlag");
1. 刪除的原理。瀏覽器沒有「刪除 cookie」的 API,唯一方法是把它設定為立即過期。這段程式碼把 expires 設為「現在減一毫秒」,等價於告訴瀏覽器這筆資料已經失效。
2. 特殊字元的編碼問題。這個實作在處理某些符號(例如 >、<)時,編碼與解碼無法完全對稱,取回來的值可能與存进去時不同。若你的 cookie 內容會含這類字元,建議改用 encode/decodeURIComponent 配對,或直接採用成熟插件。
3. 只用 !val 判斷會有盲點。當你想存入的值本身是 0、空字串或 false 時,!val 為 true,程式會誤判成「要取值」而不是「要賦值」。更嚴謹的寫法應該用 arguments.length 或 val === undefined 來區分。
4. 這個版本缺少選項參數。完整的 cookie 操作還需要能設定 path、domain、expires 等屬性,否則預設的作用範圍會受限於當前路徑。實務上建議直接使用 jquery.cookie 或 js-cookie 這類成熟方案,它們把這些邊界情況都處理好了。