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=[e-mail]; lastvisited=index.html

这意味着，文档包含 3 个 Cookies：name, email 和 lastvisited，它们的值分别是 kevin, [e-mail] 和 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的函数：

view plaincopy to clipboardprint?

   1. ///设置cookie  
   2. function setCookie(NameOfCookie, value, expiredays)  
   3. {  
   4. //@参数:三个变量用来设置新的cookie:  
   5. //cookie的名称,存储的Cookie值,  
   6. // 以及Cookie过期的时间.  
   7. // 这几行是把天数转换为合法的日期  
   8.  
   9. var ExpireDate = new Date ();  
  10. ExpireDate.setTime(ExpireDate.getTime() + (expiredays * 24 * 3600 * 1000));  
  11.  
  12. // 下面这行是用来存储cookie的,只需简单的为"document.cookie"赋值即可.  
  13. // 注意日期通过toGMTstring()函数被转换成了 GMT时间。  
  14.  
  15. document.cookie = NameOfCookie + "=" + escape(value) +  
  16.   ((expiredays == null) ? "" : "; expires=" + ExpireDate.toGMTString());  
  17. }  
  18.  
  19. ///获取cookie值  
  20. function getCookie(NameOfCookie)  
  21. {  
  22.  
  23. // 首先我们检查下cookie是否存在.  
  24. // 如果不存在则document.cookie的长度为0  
  25.  
  26. if (document.cookie.length > 0)  
  27. {  
  28.  
  29. // 接着我们检查下cookie的名字是否存在于 document.cookie  
  30.  
  31. // 因为不止一个cookie值存储,所以即使 document.cookie的长度不为0也不能保证我们想要的名字的cookie存在  
  32. //所以我们需要这一步看看是否有我们想要的cookie  
  33. //如果begin的变量值得到的是-1那么说明不存在  
  34.  
  35. begin = document.cookie.indexOf(NameOfCookie+"=");  
  36. if (begin != -1)     
  37. {  
  38.  
  39. // 说明存在我们的cookie.  
  40.  
  41. begin += NameOfCookie.length+1;//cookie值的初始位置  
  42. end = document.cookie.indexOf(";", begin);//结束位置  
  43. if (end == -1) end = document.cookie.length;//没有;则end为字符串结束位置  
  44. return unescape(document.cookie.substring(begin, end)); }  
  45. }  
  46.  
  47. return null;  
  48.  
  49. // cookie不存在返回null  
  50. }  
  51.  
  52. ///删除cookie  
  53. function delCookie (NameOfCookie)  
  54. {  
  55. // 该函数检查下cookie是否设置，如果设置了则将过期时间调到过去的时间;  
  56. //剩下就交给操作系统适当时间清理cookie啦  
  57.  
  58. if (getCookie(NameOfCookie)) {  
  59. document.cookie = NameOfCookie + "=" +  
  60. "; expires=Thu, 01-Jan-70 00:00:01 GMT";  
  61. }  
  62. } 

///设置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"; } }

演示文件

view plaincopy to clipboardprint?

   1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">  
   2. <html xmlns="http://www.w3.org/1999/xhtml">  
   3. <head>  
   4. <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />  
   5. <title>Cookie</title>  
   6. <mce:style type="text/css"><!-- 
   7.   
   8. #welcome h3  
   9. {  
  10. font-weight:normal;  
  11. color:#800;  
  12. }  
  13. --></mce:style><style type="text/css" mce_bogus="1">  
  14. #welcome h3  
  15. {  
  16. font-weight:normal;  
  17. color:#800;  
  18. } </style>  
  19. <mce:script type="text/javascript" src="cookie.js" mce_src="cookie.js"></mce:script>  
  20. <mce:script type="text/javascript"><!-- 
  21.   
  22.  
  23. //---------------使用cookie----------------------  
  24. function useCookie()  
  25. {  
  26. var username=getCookie("username");  
  27. if(username!=null){  
  28. document.getElementById('welcome').innerHTML="<h3>欢迎您,"+username+"</h3>"+"<button onclick='delusr();'>删除用户名</button>";  
  29. }else{  
  30. var str="<h3>欢迎您,游客!</h3>"+  
  31.   "<input id='usrname' type='text' />"+  
  32.   "<button id='saveusr' onclick='checksave();'>保存用户名</button>";  
  33. document.getElementById('welcome').innerHTML=str;  
  34. }  
  35. }  
  36.  
  37. function checksave()  
  38. {  
  39. var el=document.getElementById('usrname');  
  40. if(el.value){  
  41. setCookie("username",el.value);  
  42. location.reload();//刷新页面  
  43. }  
  44. else  
  45. alert("输入框不能为空");  
  46. }  
  47.  
  48. function delusr()  
  49. {  
  50. delCookie("username");  
  51. location.reload();  
  52. }  
  53. // --></mce:script>  
  54. </head>  
  55. <body onload="useCookie();">  
  56. <div id="welcome">  
  57. </div>  
  58. </body>  
  59. </html>