DIV CSS 佈局教程網

JavaScript Cookie 操作詳解:設定、讀取、過期與刪除
編輯:關於JavaScript     

Cookie 機制是在客戶端保存狀態,而 session 機制是在伺服器端保存狀態。由於 session 在客戶端也需要保存一個識別碼,因此它常需要借助 cookie 來達到目的——但這並非唯一選擇。

設定 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";

讀取 Cookie

 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>

刪除 Cookie

沒有專用的刪除 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>

用 jQuery 外掛操作更省事

會話 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 不適合存放敏感資料,畢竟它明文存在使用者端。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved