Cookie 機制是在客戶端保存狀態,而 session 機制是在伺服器端保存狀態。由於 session 在客戶端也需要保存一個識別碼,因此它常需要借助 cookie 來達到目的——但這並非唯一選擇。
每個 cookie 都是一個名/值對,只要把字串賦值給 document.cookie:
document.cookie="userId=828";
要一次存多組,用「分號 + 空格」隔開:
document.cookie="userId=828; userName=hulk";
名稱與值中不能出現分號、逗號、等號與空格。名稱要遵守很簡單,但值往往不可控,這時用 escape() 編碼:
document.cookie="str="+escape("I love ajax");
// 相當於 document.cookie="str=I%20love%20ajax";
取出時記得用 unescape() 解碼。這個做法除了處理特殊符號,也能避免中文亂碼。
document.cookie 看起來像個普通屬性,但它的行為完全不同——重新賦值不會覆蓋舊值,而是新增一筆:
document.cookie="userId=828"; document.cookie="userName=hulk";
執行完這兩行,瀏覽器會同時保存 userId 與 userName 兩個 cookie。與其說是賦值,不如說它比較像:
document.addCookie("userId=828");
document.addCookie("userName=hulk");
因此要修改既有 cookie,只要用同樣的名稱再寫一次即可(會自動覆蓋):
document.cookie="userId=929";
var strCookie=document.cookie;
這會得到該域名下所有 cookie 組成的、以分號分隔的字串:
<script language="JavaScript" type="text/javascript"> <!-- document.cookie="userId=828"; document.cookie="userName=hulk"; var strCookie=document.cookie; alert(strCookie); //--> </script>
麻煩之處在於:無法指定名稱讀取單一 cookie,必須自己解析這個字串。例如取出 userId:
<script language="JavaScript" type="text/javascript">
<!--
//設置兩個cookie
document.cookie="userId=828";
document.cookie="userName=hulk";
//獲取cookie字符串
var strCookie=document.cookie;
//將多cookie切割為多個名/值對
var arrCookie=strCookie.split("; ");
var userId;
//遍歷cookie數組,處理每個cookie對
for(var i=0;i<arrCookie.length;i++){
var arr=arrCookie[i].split("=");
//找到名稱為userId的cookie,並返回它的值
if("userId"==arr[0]){
userId=arr[1];
break;
}
}
alert(userId);
//-->
</script>
技巧核心仍是字串與陣列操作:先 split 成多組,再逐一拆解比對。
不指定過期時間的 cookie 稱為會話 cookie,它只存在記憶體中,瀏覽器關閉即消失。若要長期保存(例如記住登入狀態),加上 expires:
document.cookie="userId=828; expires=GMT_String";
GMT_String 是以 GMT 格式表示的時間字串。例如設為 10 天後過期:
<script language="JavaScript" type="text/javascript"> <!-- //獲取當前時間 var date=new Date(); var expireDays=10; //將date設置為10天以後的時間 date.setTime(date.getTime()+expireDays*24*3600*1000); //將userId和userName兩個cookie設置為10天後過期 document.cookie="userId=828; userName=hulk; expire="+date.toGMTString(); //--> </script>
沒有專用的刪除 API,做法是把過期時間設為過去:
<script language="JavaScript" type="text/javascript"> <!-- //獲取當前時間 var date=new Date(); //將date設置為過去的時間 date.setTime(date.getTime()-10000); //將userId這個cookie刪除 document.cookie="userId=828; expire="+date.toGMTString(); //--> </script>
會話 cookie(未指定 expires,關閉瀏覽器即失效):
$.cookie('cookieName', 'cookieValue');
持久 cookie(有效期以「天」為單位):
$.cookie('cookieName', 'cookieValue', {expires: 7});
指定路徑:若不設定,預設只有當前頁面能讀取。路徑用於指定可讀取該 cookie 的頂層目錄:
$.cookie('cookieName', 'cookieValue', {expires: 7, path: '/'});
指定網域與其他選項:
$.cookie('cookieName', 'cookieValue', {
expires: 7,
path: '/',
domain: 'chuhoo.com',
secure: false,
raw: false
});
參數說明:domain 是建立 cookie 的頁面所屬網域;secure 預設 false,設為 true 時要求以 https 傳輸;raw 預設 false,會自動編碼解碼(寫入用 encodeURIComponent、讀取用 decodeURIComponent),若要關閉這個行為請設為 true。
讀取:
$.cookie('cookieName'); //存在則回傳值,否則回傳 null
刪除:
$.cookie('cookieName', null);
//若要刪除帶路徑的cookie
$.cookie('cookieName', null, {path: '/'});
最後提醒一個實務上的重點:path 若不寫清楚,很容易出現「明明設了卻讀不到」的狀況,因為刪除時也必須帶上相同的 path 才能成功。另外,cookie 不適合存放敏感資料,畢竟它明文存在使用者端。