document.cookie的使用

作者:周星 发布:2017-10-07

       我们已经知道,在 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=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 了。

附一个老外写的js操作cookie的函数:

设置cookie

function setCookie(NameOfCookie, value, expiredays){
  /* @参数:三个变量用来设置新的cookie
   * cookie的名称,存储的Cookie值
   * 以及Cookie过期的时间
   * 这几行是把天数转换为合法的日期 */
  
  var ExpireDate = new Date();
  ExpireDate.setTime(ExpireDate.getTime() + (expiredays * 24 * 60 * 60 *1000));

  /* 下面这行是用来存储cookie的,只需简单的为document.cookie赋值即可
   注意日期通过toGMTstring()函数被转换成了GMT时间。 */

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

获取cookie值

function getCookie(NameOfCookie) {
/* 首先我们检查下cookie是否存在。
  如果不存在则document.cookie.length的长度为0 */
  if(document.cookie.length > 0) {
    /* 接着我们检查下cookie的名字是否存在于document.cookie,
     * 因为不止一个cookie值存储,所以即使document.cookie的长度不为0也不能保证我们想要的名字的cookie存在
     * 所以我们需要这一步看看是否有我们想要的cookie
     * 如果begin的变量值是-1那么说明不存在 */
    var begin = document.cookie.indexOf(NameOfCookie+"=");
    if(begin != -1) {
      //说明存在我们的cookie.
      begin += NameOfCookie.length + 1; //cookie值的初始位置
      end = document.cookie.indexOf(";", begin);//结束位置
      
      if(end == -1) {    //没有分号,则end为字符串结束
        end = document.cookie.length;
      }
      
      return unescape(document.cookie.substring(begin, end));
      //cookie不存在返回null
}

删除cookie

function delCookie(NameOfCookie){
/* 该函数检查下cookie是否设置,如果设置了则将过期时间调到过去的时间;剩下的就交个操作系统适当时间清理cookie啦 */
  if(getCookie(NameOfCookie)){
    document.cookie = NameOfCookie + "=" + ";expire = Thu, 01-Jan-70 00:00:01 GMT;
  }
}

附:《javascript权威指南》关于cookie的一段介绍:cookie是一个字符串属性,可以用它对当前网页的cookie进行读操作、创建操作、修改操作和删除操作。尽管cookie最初呈现出来的不过是一个可读写的普通字符串属性,但是它的行为要复杂得多。

支付宝扫码赞助博主


评论(0)