先前寫過一篇 Cookie 操作的筆記,實測之後發現兩個問題:
1. 在本地檔案(file:// 協定)下,Cookie 只有 Firefox 能正常除錯,IE 與 Chrome 皆無效。
2. 原先只實作了「設定一段時間後過期」,缺少「永不過期」的選項,實務上不夠合理。
以下是修正後的版本:
var Cookie = {
get: function (k) {
return ((new RegExp(["(?:; )?", k, "=([^;]*);?"].join(""))).test(document.cookie) && RegExp["$1"]) || "";
},
set: function (k, v, e, d) {
var date=new Date();
var expiresDays=e;
date.setTime(date.getTime()+expiresDays*24*3600*1000);
//如果有設置時間,則在規定時間內使用 cookie,否則就是永不過期
document.cookie=k+"="+v+"; expires="+ (e != '' ? date.toGMTString(): "GMT_String")+";path=/;domain="+ (d||'');
},
del: function (k) {
var date=new Date();
//將 date 設置為過去的時間
date.setTime(date.getTime()-10000);
document.cookie=k+"=; expires="+date.toGMTString();
}
};
三個方法的思路都很直觀:get 用正則從 document.cookie 字串中撈出目標鍵的值;set 藉由計算 expires 決定存活時間,並統一帶上 path 與 domain;del 則把過期時間設為過去,讓瀏覽器主動清除。
要留意 set 裡的 "GMT_String" 其實是個無效的日期字串,瀏覽器遇到無法解析的 expires 時會視為「會話 Cookie」,也就是關閉瀏覽器後消失——效果上接近但不完全等同於「永久」。若要明確做到長期保存,建議改成一個遠方的合法時間,例如 date.setFullYear(date.getFullYear() + 10)。另外 toGMTString 已被標準更名為 toUTCString,新程式碼請用後者。
下面的例子示範點擊標題展開內容、再次點擊收合;並且把狀態寫入 Cookie,下次開啟頁面時會維持上次的顯示狀態。
<div class="tab">
<h3 class="tab-header">收縮</h3>
<div class="tab-con" id="tabCon">
<p>展開之後可見這裡的內容</p>
</div>
</div>
var btn = document.getElementsByTagName('h3')[0];
btn.addEventListener('click',function(){
var isClose = this.getAttribute('data-isClose');
if(isClose == 'close'){
show();
Cookie.del('flag');
}else{
hide();
Cookie.set('flag','hide');
}
});
var tabCon = document.getElementById('tabCon');
function show(){
tabCon.style.display = 'block';
btn.setAttribute('data-isClose','open');
btn.innerHTML = '收縮';
}
function hide(){
tabCon.style.display = 'none';
btn.setAttribute('data-isClose','close');
btn.innerHTML = '展開';
}
var flag = Cookie.get('flag');
if(flag == 'hide'){
hide();
}
這個範例的重點在最後三行:頁面載入時先讀一次 Cookie,若上次記錄為隱藏就立即套用 hide()。把「使用者偏好」寫進 Cookie,是很常見也很實用的輕量持久化手段。
最後補充一個現代觀點:Cookie 的 get 方法用正則比對時,若鍵名可能包含特殊字元,建議改用 encodeURIComponent 編碼後比對;而若只是要儲存前端狀態(而非必須隨請求送給伺服器的資料),localStorage 會是更合適的選擇——容量更大,也不會增加每次請求的負擔。