设置COOKIE
每个COOKIE都是一个名/值对,可以把下面这样一个字符串赋值给document.COOKIE:
document.COOKIE="userId=828";
如果要一次存储多个名/值对,可以使用分号加空格(; )隔开,例如:
document.COOKIE="userId=828; userName=hulk";
在COOKIE的名或值中不能使用分号(;)、逗号(,)、等号(=)以及空格。在COOKIE的名中做
到这点很容易,但要保存的值是不确定的。如何来存储这些值呢?方法是用escape()函数进行编码,它能将一些特殊符号使用十六进制表示,例如空格将会编码为“20%”,从而可以存储于
COOKIE值中,而且使用此种方案还可以避免中文乱码的出现。例如:
document.COOKIE="str="+escape("I love ajax");
相当于:
document.COOKIE="str=I%20love%20ajax";
当使用escape()编码后,在取出值以后需要使用unescape()进行解码才能得到原来的COOKIE值。
尽管document.COOKIE看上去就像一个属性,可以赋不同的值。但它和一般的属性不一样,改变它的赋值并不意味着丢失原来的值,例如连续执行下面两条语句:
document.COOKIE="userId=828";
document.COOKIE="userName=hulk";
这时浏览器将维护两个COOKIE,分别是userId和userName,因此给document.COOKIE赋值更像执行类似这样的语句:
document.addCOOKIE("userId=828");
document.addCOOKIE("userName=hulk");
事实上,浏览器就是按照这样的方式来设置COOKIE的,如果要改变一个COOKIE的值,只需重新赋值,例如:
document.COOKIE="userId=929";
这样就将名为userId的COOKIE值设置为了929。
获取COOKIE的值
下面介绍如何获取COOKIE的值。COOKIE的值可以由document.COOKIE直接获得:
var strCOOKIE=document.COOKIE;
这将获得以分号隔开的多个名/值对所组成的字符串,这些名/值对包括了该域名下的所有COOKIE
名称来获得指定的值,这正是处理COOKIE值最麻烦的一部分。用户必须自己分析这个字符串,来获取指定的COOKIE值,例如,要获取userId的值,可以这样实现:
用类似的方法,可以获取一个或多个COOKIE的值,其主要的技巧仍然是字符串和数组的相关操作.
给COOKIE设置终止日期
到现在为止,所有的COOKIE都是单会话COOKIE,即浏览器关闭后这些COOKIE将会丢失,事实上这些COOKIE仅仅是存储在内存中,而没有建立相应的硬盘文件。
在实际开发中,COOKIE常常需要长期保存,例如保存用户登录的状态。这可以用下面的选项来实现:
document.COOKIE="userId=828; expires=GMT_String";
其中GMT_String是以GMT格式表示的时间字符串,这条语句就是将userId这个COOKIE设置为
GMT_String表示的过期时间,超过这个时间,COOKIE将消失,不可访问。例如:如果要将COOKIE
设置为10天后过期,可以这样实现:
删除COOKIE
为了删除一个COOKIE,可以将其过期时间设定为一个过去的时间,例如:
指定可访问COOKIE的路径
默认情况下,如果在某个页面创建了一个COOKIE,那么该页面所在目录中的其他页面也可以访问该COOKIE。如果这个目录下还有子目录,则在子目录中也可以访问。例如在
www.xxxx.com/html/a.html中所创建的COOKIE,可以被www.xxxx.com/html/b.html或
www.xxx.com/ html/ some/c.html所访问,但不能被www.xxxx.com/d.html访问。
为了控制COOKIE可以访问的目录,需要使用path参数设置COOKIE,语法如下:
document.COOKIE="name=value; path=COOKIEDir";
其中COOKIEDir表示可访问COOKIE的目录。例如:
document.COOKIE="userId=320; path=/shop";
就表示当前COOKIE仅能在shop目录下使用。
如果要使COOKIE在整个网站下可用,可以将COOKIE_dir指定为根目录,例如:
document.COOKIE="userId=320; path=/";
指定可访问COOKIE的主机名
和路径类似,主机名是指同一个域下的不同主机,例如:www.google.com和gmail.google.com就是两个不同的主机名。默认情况下,一个主机中创建的COOKIE在另一个主机下是不能被访问的,但可以通过domain参数来实现对其的控制,其语法格式为:
document.COOKIE="name=value; domain=COOKIEDomain";
以google为例,要实现跨主机访问,可以写为:
document.COOKIE="name=value;domain=.google.com";
这样,所有google.com下的主机都可以访问该COOKIE。
综合示例:构造通用的COOKIE处理函数
COOKIE的处理过程比较复杂,并具有一定的相似性。因此可以定义几个函数来完成COOKIE的通用
操作,从而实现代码的复用。下面列出了常用的COOKIE操作及其函数实现。
1.添加一个COOKIE:addCOOKIE(name,value,expireHours)
该函数接收3个参数:COOKIE名称,COOKIE值,以及在多少小时后过期。这里约定expireHours为0时不设定过期时间,即当浏览器关闭时COOKIE自动消失。该函数实现如下:
2.获取指定名称的COOKIE值:getCOOKIE(name)
该函数返回名称为name的COOKIE值,如果不存在则返回空,其实现如下:
3.删除指定名称的COOKIE:deleteCOOKIE(name)
该函数可以删除指定名称的COOKIE,其实现如下:
我们已经知道,在 document 对象中有一个 COOKIE 属性。但是 COOKIE 又是什么?“某些 Web 站点在您的硬盘上用很小的文本文件存储了一些信息,这些文件就称为 COOKIE。”—— MSIE 帮助。一般来说,COOKIEs 是 CGI 或类似,比 HTML 高级的文件、程序等创建的,但是 Javascript 也提供了对 COOKIEs 的很全面的访问权利。
我们先要学一学 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=kevin@kevin.com; lastvisited=index.html
这意味着,文档包含 3 个 COOKIEs:name, email 和 lastvisited,它们的值分别是 kevin, kevin@kevin.com 和 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 了。
COOKIEs的理解