JavaScript中的document.cookie的使用

 

我們已經知道,在 document 對象中有一個 cookie 屬性。但是 Cookie 又是什麼?“某些 Web 站點在您的硬盤上用很小的文本文件存儲了一些信息,這些文件就稱爲 Cookie。”—— MSIE 幫助。一般來說,Cookies 是 CGI 或類似,比 HTML 高級的文件、程序等創建的,但是 javascript 也提供了對 Cookies 的很全面的訪問權利。

  我們先要學一學 Cookie 的基本知識。

  每個 Cookie 都是這樣的:<cookie名>=<值>

  <cookie名>的限制與 javascript 的命名限制大同小異,少了“不能用 javascript 關鍵字”,多了“只能用可以用在 URL 編碼中的字符”。後者比較難懂,但是隻要你只用字母和數字命名,就完全沒有問題了。<值>的要求也是“只能用可以用在 URL 編碼中的字符”。

  每個 Cookie 都有失效日期,一旦電腦的時鐘過了失效日期,這個 Cookie 就會被刪掉。我們不能直接刪掉一個 Cookie,但是可以用設定失效日期早於現在時刻的方法來間接刪掉它。

  每個網頁,或者說每個站點,都有它自己的 Cookies,這些 Cookies 只能由這個站點下的網頁來訪問,來自其他站點或同一站點下未經授權的區域的網頁,是不能訪問的。每一“組”Cookies 有規定的總大小(大約 2KB 每“組”),一超過最大總大小,則最早失效的 Cookie 先被刪除,來讓新的 Cookie“安家”。

  現在我們來學習使用 documents.cookie 屬性。

  如果直接使用 documents.cookie 屬性,或者說,用某種方法,例如給變量賦值,來獲得 documents.cookie 的值,我們就可以知道在現在的文檔中有多少個 Cookies,每個 Cookies 的名字,和它的值。例如,在某文檔中添加“document.write(documents.cookie)”,結果顯示:

name=kevin; [email protected]; lastvisited=index.html

這意味着,文檔包含 3 個 Cookies:name, email 和 lastvisited,它們的值分別是 kevin, [email protected] 和 index.html。可以看到,兩個 Cookies 之間是用分號和空格隔開的,於是我們可以用 cookieString.split('; ') 方法得到每個 Cookie 分開的一個數組(先用 var cookieString = documents.cookie)。

  設定一個 Cookie 的方法是對 documents.cookie 賦值。與其它情況下的賦值不同,向 documents.cookie 賦值不會刪除掉原有的 Cookies,而只會增添 Cookies 或更改原有 Cookie。賦值的格式:

documents.cookie = 'cookieName=' + escape('cookievalue')
+ ';expires=' + expirationDateObj.toGMTString();

是不是看到頭暈了呢?cookieName 表示 Cookie 的名稱,cookievalue 表示 Cookie 的值,expirationDateObj 表示儲存着失效日期的日期對象名,如果不需要指定失效日期,則不需要第二行。不指定失效日期,則瀏覽器默認是在關閉瀏覽器(也就是關閉所有窗口)之後過期。

  首先 escape() 方法:爲什麼一定要用?因爲 Cookie 的值的要求是“只能用可以用在 URL 編碼中的字符”。我們知道“escape()”方法是把字符串按 URL 編碼方法來編碼的,那我們只需要用一個“escape()”方法來處理輸出到 Cookie 的值,用“unescape()”來處理從 Cookie 接收過來的值就萬無一失了。而且這兩個方法的最常用途就是處理 Cookies。其實設定一個 Cookie 只是“documents.cookie = 'cookieName=cookievalue'”這麼簡單,但是爲了避免在 cookievalue 中出現 URL 裏不準出現的字符,還是用一個 escape() 好。
  然後“expires”前面的分號:注意到就行了。是分號而不是其他。
  最後 toGMTString() 方法:設定 Cookie 的時效日期都是用 GMT 格式的時間的,其它格式的時間是沒有作用的。

  現在我們來實戰一下。設定一個“name=rose”的 Cookie,在 3 個月後過期。

var expires = new Date();
expires.setTime(expires.getTime() + 3 * 30 * 24 * 60 * 60 * 1000);
/* 三個月 x 一個月當作 30 天 x 一天 24 小時
x 一小時 60 分 x 一分 60 秒 x 一秒 1000 毫秒 */
documents.cookie = 'name=rose;expires=' + expires.toGMTString();

爲什麼沒有用 escape() 方法?這是因爲我們知道 rose 是一個合法的 URL 編碼字符串,也就是說,'rose' == escape('rose')。一般來說,如果設定 Cookie 時不用 escape(),那獲取 Cookie 時也不用 unescape()。

  再來一次:編寫一個函數,作用是查找指定 Cookie 的值。

function getCookie(cookieName) {
var cookieString = documents.cookie;
var start = cookieString.indexOf(cookieName + '=');
// 加上等號的原因是避免在某些 Cookie 的值裏有
// 與 cookieName 一樣的字符串。
if (start == -1) // 找不到
return null;
start += cookieName.length + 1;
var end = cookieString.indexOf(';', start);
if (end == -1) return unescape(cookieString.substring(start));
return unescape(cookieString.substring(start, end));
}

這個函數用到了字符串對象的一些方法,如果你不記得了(你是不是這般沒記性啊),請快去查查。這個函數所有的 if 語句都沒有帶上 else,這是因爲如果條件成立,程序運行的都是 return 語句,在函數裏碰上 return,就會終止運行,所以不加 else 也沒問題。該函數在找到 Cookie 時,就會返回 Cookie 的值,否則返回“null”。

  現在我們要刪除剛纔設定的 name=rose Cookie。

var expires = new Date();
expires.setTime(expires.getTime() - 1);
documents.cookie = 'name=rose;expires=' + expires.toGMTString();

可以看到,只需要把失效日期改成比現在日期早一點(這裏是早 1 毫秒),再用同樣的方法設定 Cookie,就可以刪掉 Cookie 了。

 

附一個老外寫的js操作cookie的函數:

///設置cookie 
function setCookie(NameOfCookie, value, expiredays) 
{ 
//@參數:三個變量用來設置新的cookie: 
//cookie的名稱,存儲的Cookie值, 
// 以及Cookie過期的時間. 
// 這幾行是把天數轉換爲合法的日期 

var ExpireDate = new Date (); 
ExpireDate.setTime(ExpireDate.getTime() + (expiredays * 24 * 3600 * 1000)); 

// 下面這行是用來存儲cookie的,只需簡單的爲"document.cookie"賦值即可. 
// 注意日期通過toGMTstring()函數被轉換成了GMT時間。 

document.cookie = NameOfCookie + "=" + escape(value) + 
  ((expiredays == null) ? "" : "; expires=" + ExpireDate.toGMTString()); 
} 

///獲取cookie值 
function getCookie(NameOfCookie) 
{ 

// 首先我們檢查下cookie是否存在. 
// 如果不存在則document.cookie的長度爲0 

if (document.cookie.length > 0) 
{ 

// 接着我們檢查下cookie的名字是否存在於document.cookie 

// 因爲不止一個cookie值存儲,所以即使document.cookie的長度不爲0也不能保證我們想要的名字的cookie存在 
//所以我們需要這一步看看是否有我們想要的cookie 
//如果begin的變量值得到的是-1那麼說明不存在 

begin = document.cookie.indexOf(NameOfCookie+"="); 
if (begin != -1)    
{ 

// 說明存在我們的cookie. 

begin += NameOfCookie.length+1;//cookie值的初始位置 
end = document.cookie.indexOf(";", begin);//結束位置 
if (end == -1) end = document.cookie.length;//沒有;則end爲字符串結束位置 
return unescape(document.cookie.substring(begin, end)); } 
} 

return null; 

// cookie不存在返回null 
} 

///刪除cookie 
function delCookie (NameOfCookie) 
{ 
// 該函數檢查下cookie是否設置,如果設置了則將過期時間調到過去的時間; 
//剩下就交給操作系統適當時間清理cookie啦 

if (getCookie(NameOfCookie)) { 
document.cookie = NameOfCookie + "=" + 
"; expires=Thu, 01-Jan-70 00:00:01 GMT"; 
} 
}
// 獲取子鍵的cookie值
function getChildCookie(cookiekey, childkey) {
    var childs = getCookie(cookiekey).split('&');
    for (var i = 0; i < childs.length; i++) {
        if (childs[i].indexOf(childkey+"=") != -1)
            return childs[i].substring(childkey.length+1, childs[i].length).replace(/\+/g,"");//替換+號
    }
    return null;
}


演示文件

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml"> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 
<title>Cookie</title> 
<mce:style type="text/css"><!--
 
#welcome h3 
{ 
font-weight:normal; 
color:#800; 
} 
--></mce:style><style type="text/css" mce_bogus="1"> 
#welcome h3 
{ 
font-weight:normal; 
color:#800; 
} </style> 
<mce:script type="text/javascript" src="cookie.js" mce_src="cookie.js"></mce:script> 
<mce:script type="text/javascript"><!--
 

//---------------使用cookie---------------------- 
function useCookie() 
{ 
var username=getCookie("username"); 
if(username!=null){ 
document.getElementById('welcome').innerHTML="<h3>歡迎您,"+username+"</h3>"+"<button οnclick='delusr();'>刪除用戶名</button>"; 
}else{ 
var str="<h3>歡迎您,遊客!</h3>"+ 
  "<input id='usrname' type='text' />"+ 
  "<button id='saveusr' οnclick='checksave();'>保存用戶名</button>"; 
document.getElementById('welcome').innerHTML=str; 
} 
} 

function checksave() 
{ 
var el=document.getElementById('usrname'); 
if(el.value){ 
setCookie("username",el.value); 
location.reload();//刷新頁面 
} 
else 
alert("輸入框不能爲空"); 
} 

function delusr() 
{ 
delCookie("username"); 
location.reload(); 
} 
// --></mce:script> 
</head> 
<body οnlοad="useCookie();"> 
<div id="welcome"> 
</div> 
</body> 
</html> 


讀取含有子鍵的cookies方法

 <script type="text/javascript"> 
//參數說明: 
//sMainName Cookie名 
//sSubName Cookie子鍵名,留空表示單值Cookie 
function GetCookie(sMainName, sSubName){ 
var re = new RegExp((sSubName ? sMainName + "=(.*?&)*?" + sSubName + "=(.*?)(&|;)" : sMainName + "=(.*?);"), "i"); 
return re.test(unescape(document.cookie)) ? (sSubName ? RegExp["$2"] : RegExp["$1"]) : ""; 
} 

ttt=GetCookie("QQ_IPAddress"); 
document.writeln (ttt); 
</script> 



函數GetCookie主要用來讀取帶子鍵的cookies例如:
使用ttt=GetCookie("user","user_name");就可以讀取下面這種形式生產隊的cookies
response.cookies("user")("user_name")=****

發佈了29 篇原創文章 · 獲贊 0 · 訪問量 18萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章