js设置cookie、读取cookie和删除cookie

关注

原创最新推荐文章于 2026-03-29 09:01:01 发布 1.3k 阅读 AI 写同款· GEO 优化 ›

什么是cookie？
cookie 是存储于访问者的计算机中的变量。每当同一台计算机通过浏览器请求某个页面时，就会发送这个 cookie。设置cookie的方法有很多种；比如通过服务器脚本页面进行设置，诸如aps,php等程序脚本。但有时候我们需要在静态页面上设置cookie，这时候我们就需要用到javascipt方法了。

在JavaScript中，使用 document.cookie 来设置 cookie 。
语法：document.cookie="name=value;expires=GMT_String;path=cookieDir;domain=cookieDomain";
下面来具体说下js设置cookie的相关用法。

设置cookie：[document.cookie=“name=value”]
每个cookie都是一个名/值对，例如，document.cookie=”user=lazyCat”;
注意，一次只能设置一个名/值对。

在cookie的名或值中不能使用分号（;）、逗号（,）、等号（=）以及空格。在cookie的名中做到这点很容易，但要保存的值是不确定的。如何来存储这些值呢？

方法是用escape()函数进行编码，它能将一些特殊符号使用十六进制表示，例如空格将会编码为“20%”，从而可以存储于cookie值中，而且使用此种方案还可以避免中文乱码的出现。
例如：document.cookie=”userName=”+escape(“敲代码的猫”);
相当于：document.cookie=”userName=%u6572%u4EE3%u7801%u7684%u732B”;

当使用escape()编码后，在取出值以后需要使用unescape()进行解码才能得到原来的cookie值。

尽管document.cookie看上去就像一个属性，可以赋不同的值。但它和一般的属性不一样，改变它的赋值并不意味着丢失原来的值，例如连续执行下面两条语句：
document.cookie=”userId=u001”;
document.cookie=”userName=lazyCat”;
这时浏览器将维护两个cookie，分别是userId和userName，因此给document.cookie赋值更像执行类似这样的语句：
document.addCookie(“userId=u001”);
document.addCookie(“userName=lazyCat”);

事实上，浏览器就是按照这样的方式来设置cookie的，如果要改变一个cookie的值，只需重新赋值，例如：document.cookie=”userId=u002”;这样就将名为userId的cookie值设置为了u002。
获取cookie值：
cookie的值可以由document.cookie直接获得：var strCookie=document.cookie;
这将获得以分号隔开的多个名/值对所组成的字符串，这些名/值对包括了该域名下的所有cookie。

<!DOCTYPE html>
<html>
<head lang="en">
    <meta charset="UTF-8">
    <title></title>
</head>
<body>
<script language="JavaScript" type="text/javascript">
    document.cookie="userId=u001";
    document.cookie="userName=lazyCat";
    var strCookie=document.cookie;
    alert(strCookie);
</script>
</body>
</html>

通过名称来获得指定的值，这正是处理cookie值最麻烦的一部分。用户必须自己分析这个字符串，来获取指定的cookie值，例如，要获取userId的值，可以这样实现：

<!DOCTYPE html>
<html>
<head lang="en">
    <meta charset="UTF-8">
    <title></title>
</head>
<body>
<script language="JavaScript" type="text/javascript">
    //设置两个cookie
    document.cookie="userId=u001";
    document.cookie="userName=lazyCat";
    //获取cookie字符串
    var strCookie=document.cookie;
    //将多cookie切割为多个名/值对
    var arrCookie=strCookie.split("; ");
    var userName;
    //遍历cookie数组，处理每个cookie对
    for(var i=0;i<arrCookie.length;i++){
        var arr=arrCookie[i].split("=");
//找到名称为userId的cookie，并返回它的值
        if("userName"==arr[0]){
            userName=arr[1];
            break;
        }
    }
    alert(userName);
</script>
</body>
</html>

用类似的方法，可以获取一个或多个cookie的值，其主要的技巧仍然是字符串和数组的相关操作。

给cookie设置过期时间：
到现在为止，所有的cookie都是单会话cookie，即浏览器关闭后这些cookie将会丢失，事实上这些cookie仅仅是存储在内存中，而没有建立相应的硬盘文件。
在实际开发中，cookie常常需要长期保存，例如保存用户登录的状态。这可以用下面的选项来实现：
document.cookie=”userId=u001; expires=GMT_String”;
其中GMT_String是以GMT格式表示的时间字符串，这条语句就是将userId这个cookie设置为GMT_String表示的过期时间，超过这个时间，cookie将消失，不可访问。例如：如果要将cookie设置为10天后过期，可以这样实现：

<!DOCTYPE html>
<html>
<head lang="en">
    <meta charset="UTF-8">
    <title></title>
</head>
<body>
<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="userName=lazyCat; expire="+date.toGMTString();
</script>
</body>
</html>

删除cookie：
过期时间是以GMT格式表示的时间字符串，超过这个时间，cookie将消失，不可访问。因此，删除一个cookie，可以将其过期时间设定为一个过去的时间，例如：document.cookie = "userId=; expires=Thu, 01 Jan 1970 00:00:00 GMT";
注意：删除时，不必指定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自动消失。该函数实现如下：

function addCookie(name,value,expireHours){
    var cookieString=name+"="+escape(value);
    //判断是否设置过期时间
    if(expireHours>0){
    var date=new Date();
    date.setTime(date.getTime+expireHours*3600*1000);
    cookieString=cookieString+"; expire="+date.toGMTString();
    }
    document.cookie=cookieString;
}

2．获取指定名称的cookie值：getCookie(name)
该函数返回名称为name的cookie值，如果不存在则返回空，其实现如下：

function getCookie(name){
var strCookie=document.cookie;
var arrCookie=strCookie.split("; ");
for(var i=0;i<arrCookie.length;i++){
var arr=arrCookie[i].split("=");
if(arr[0]==name)return arr[1];
}
return "";
}

getCookie方法不唯一，很多种方法可以实现，比如：

function getCookie(cookie_name){
var results = document.cookie.match('(^|;) ?' + cookie_name + '=([^;]*)(;|$)');
if (results)
return (unescape(results[2]));
else
return null;
}

3．删除指定名称的cookie：deleteCookie(name)
该函数可以删除指定名称的cookie，其实现如下：

function deleteCookie(name){
        var date=new Date();
        date.setTime(date.getTime()-10000);
        document.cookie=name+"=; expire="+date.toGMTString();
    }

检测 cookie 值的函数
最后，我们可以创建一个检测 cookie 是否创建的函数。
如果设置了 cookie，将显示一个问候信息。
如果没有设置 cookie，将会显示一个弹窗用于询问访问者的名字，并调用 setCookie 函数将访问者的名字存储 365 天：

function checkCookie()
{
  var username=getCookie("username");
  if (username!="")
  {
    alert("Welcome again " + username);
  }
  else 
  {
    username = prompt("Please enter your name:","");
    if (username!="" && username!=null)
    {
      setCookie("username",username,365);
    }
  }
}

另外要注意的是，cookie中的name名字是区分大小写的。
这个案例代码如下：

<!DOCTYPE html>
<html>
<head lang="en">
    <meta charset="UTF-8">
    <title></title>
</head>
<input type="button" value="添加userName" onclick="addCookie('userName','lazyCat',10)"/>
<input type="button" value="获取userName" onclick="alert(getCookie('userName'))"/>
<input type="button" value="删除userName" onclick="deleteCookie('userName')"/>
<input type="button" value="userName是否存在" onclick="checkCookie()"/>
<body>
<script language="JavaScript" type="text/javascript">
    function addCookie(name,value,expireHours){
        var cookieString=name+"="+escape(value);
        //判断是否设置过期时间
        if(expireHours>0){
            var date=new Date();
            date.setTime(date.getTime+expireHours*3600*1000);
            cookieString=cookieString+"; expire="+date.toGMTString();
        }
        document.cookie=cookieString;
    }
/*    function getCookie(name){
        var strCookie=document.cookie;
        var arrCookie=strCookie.split("; ");
        for(var i=0;i<arrCookie.length;i++){
            var arr=arrCookie[i].split("=");
            if(arr[0]==name)return arr[1];
        }
        return "";
    }*/
   function getCookie(cookie_name){
        var results = document.cookie.match('(^|;) ?' + cookie_name + '=([^;]*)(;|$)');
        if (results)
            return (unescape(results[2]));
        else
            return null;
    }
    function deleteCookie(name){
        var date=new Date();
        date.setTime(date.getTime()-10000);
        document.cookie=name+"=; expire="+date.toGMTString();
    }
    function checkCookie()
    {
        var username=getCookie("userName");
        if (username!="")
        {
            alert("Welcome again " + username);
        }
        else
        {
            username = prompt("Please enter your name:","");
            if (username!="" && username!=null)
            {
                addCookie("userName",username,365);
            }
        }
    }
</script>
</body>
</html>