JavaScript

JS之cookie操作(设置、获取和删除)

下文笔者讲述使用javascript代码设置cookie,获取cookie,删除cookie的方法分享,如下所示

cookie简介

cookie是存储在计算机上的一个文件
cookie常用于web网站中
   当用户访问一个网站,此时会存储用户的信息,方便同服务器进行交互时,标记用户身份
cookie采用键值对的形式将用户信息存储在客户端

JS 设置Cookie

在 JavaScript 中
  可使用document.cookie属性来创建、读取、修改和删除 Cookie 信息。
创建(设置)新的 Cookie信息
以name=value形式的字符串来定义新Cookie
document.cookie = "url=https://www.linux28.com/";
Cookie数据中不能包含分号、逗号或空格
因此在将数据存储到 Cookie 之前
可使用JavaScript内置encodeURIComponent()函数对数据进行编码
 在读取Cookie时
   使用对应decodeURIComponent()函数来解析Cookie数据
document.cookie = "url=" + encodeURIComponent("https://www.linux28.com/");

Cookie有效期简介

Cookie并不会一直存在
 默认情况下,Cookie生命周期就是浏览器的会话周期

当用户关闭浏览器后,Cookie 就会失效
延长Cookie生命周期,可使用max-age属性来指定 Cookie 可以存在的时间(单位为秒)
默认为 -1,即关闭浏览器后失效。

当将max-age设置为一个负数,则表示该 Cookie 为临时 Cookie,关闭浏览器后就会失效
当设置为 0,则表示删除该 Cookie

若要将 Cookie 的生命周期设置为 30 天的话,则可以像下面这样:
document.cookie = "url=https://www.linux28.com/; max-age=" + 30*24*60*60;

也可以使用 expires 属性来指定 Cookie 失效的具体日期(GMT/UTC 格式),如下所示:
document.cookie = "url=https://www.linux28.com/; expires=Sun,22 Dec 2023 12:00:00 UTC;";

Cookie的作用范围

默认情况下
   Cookie 可用于同一域名下的所有网页
当为Cookie设置path属性后,则Cookie就只能在该域名指定路径下的网页中使用
 
 如:
  网站的域名为 www.linux28.com
  当path 属性设置为/
  则表示 Cookie 可在域名下的所有网页中使用

当path属性设置为/javascript/
   则 Cookie 只可在 https://www.linux28.com/javascript/ 下的网页中使用

例:
document.cookie = "url=https://www.linux28.com/; path=/";

当你希望Cookie可在指定域名下的子域名中使用
  则可以通过 domain 属性来设置
   默认情况下,Cookie 仅可在设置它的域名下使用

例
document.cookie = "url=https://www.linux28.com/; path=/; domain=.linux28.com";

当将domain 属性设置为.linux28.com
   则表示 Cookie 可在所有以linux28.com结尾的域名下使用
    注意,domain 属性值的第一个字符.不能省略。

secure属性简介说明

Cookie中有一个属性secure
 该属性只有一个属性名,没有属性值
当设置该属性,则表示 Cookie 将仅通过 HTTPS 协议传输

例:
document.cookie = "url=https://www.linux28.com/; path=/; domain=.linux28.com; secure";

Cookie设置工具类

/**
* 添加 Cookie
* @param {[string]} name       [Cookie 的名称]
* @param {[string]} value      [Cookie 的值]
* @param {[number]} daysToLive [Cookie 的过期时间]
*/
function setCookie(name, value, daysToLive) {
    // 对 cookie 值进行编码以转义其中的分号、逗号和空格
    var cookie = name + "=" + encodeURIComponent(value);
   
    if(typeof daysToLive === "number") {
        /* 设置 max-age 属性 */
        cookie += "; max-age=" + (daysToLive*24*60*60);
    }
    document.cookie = cookie;
}

JS 获取 Cookie

JavaScript获取cookie
  使用document.cookie即可
例:
//设置cookie
document.cookie = "course=JavaScript";
document.cookie = "title=cookie";       

//获取cookie工具类
function getCookie(name) {
    // 拆分 cookie 字符串
    var cookieArr = document.cookie.split(";");
   
    // 循环遍历数组元素
    for(var i = 0; i < cookieArr.length; i++) {
        var cookiePair = cookieArr[i].split("=");
       
        /* 删除 cookie 名称开头的空白并将其与给定字符串进行比较 */
        if(name == cookiePair[0].trim()) {
            // 解码cookie值并返回
            return decodeURIComponent(cookiePair[1]);
        }
    }
    // 如果未找到,则返回null
    return null;
}

document.write("url = " + getCookie("url") + "<br>");           // 输出:url = https://www.linux28.com/
document.write("course = " + getCookie("course") + "<br>");     // 输出:course = JavaScript
document.write("title = " + getCookie("title"));                // 输出:title = cookie

JS 修改或更新 Cookie值

修改或更新Cookie值的唯一方法:
   创建一个同名的 Cookie
   来替换要修改的 Cookie
 
 注意事项:
  若要修改Cookie中,定义path属性
   在修改该属性时也要定义相同path属性
   否则会创建一个新的 Cookie
// 创建一个 Cookie
document.cookie = "url=https://www.linux28.com/; path=/; max-age=" + 30*24*60*60;
// 修改这个 Cookie
document.cookie = "url=https://www.linux28.com/javascript/; path=/; max-age=" + 365*24*60*60;
提示:当path 属性为/,在修改时也可以省略 path 属性。

JS 删除 Cookie
删除 Cookie 与修改 Cookie 类似,只需要重新将 Cookie 的值设置为空
  并将 expires 属性设置为一个过去的日期即可,如下例所示:
// 创建一个 Cookie
document.cookie = "url=https://www.linux28.com/; path=/; max-age=" + 30*24*60*60;
// 删除这个 Cookie
document.cookie = "url=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/;";
另外
 也可通过将 max-age 属性设置为 0 来删除 Cookie