首页 > web前端 > js教程 > 正文

怎么使用JavaScript操作Cookie的过期时间?

幻影之瞳
发布: 2025-09-20 16:28:01
原创
736人浏览过
答案:JavaScript通过document.cookie设置Cookie过期时间需使用expires属性并配合UTC格式日期字符串。核心方法是利用Date对象的toUTCString()生成正确格式的时间,并通过拼接字符串方式设置,若未设置expires则生成会话Cookie;常见做法是封装setCookie函数传入天数自动计算过期时间,同时指定path=/确保作用域覆盖全站;删除Cookie需将expires设为过去时间且必须匹配原Cookie的path和domain属性;影响Cookie生命周期的还有secure、HttpOnly和SameSite等关键属性,分别控制传输安全、脚本访问权限及跨站请求行为,其中path和domain设置不当常导致访问异常,是开发中易错点。

怎么使用javascript操作cookie的过期时间?

使用JavaScript操作Cookie的过期时间,核心在于设置

expires
登录后复制
属性。这个属性需要一个特定格式的日期字符串,通常是UTC时间,告诉浏览器这个Cookie应该在何时失效并被删除。如果你不显式设置这个属性,那么Cookie通常会成为一个会话Cookie,也就是在用户关闭浏览器时就会自动消失。

要通过JavaScript设置Cookie的过期时间,我们主要依赖

document.cookie
登录后复制
这个API。当你在设置一个Cookie时,可以通过追加
expires=DateString
登录后复制
来指定它的失效日期。这个
DateString
登录后复制
必须是GMT或UTC格式的日期字符串,最可靠的方式是使用
Date
登录后复制
对象的
toUTCString()
登录后复制
方法来生成。

一个常见的实践是创建一个辅助函数来管理Cookie的设置,这样可以更好地封装逻辑,比如计算未来某个日期的UTC字符串。

function setCookie(name, value, days) {
    let expires = "";
    if (days) {
        const date = new Date();
        // 计算从现在开始days天后的时间戳
        date.setTime(date.getTime() + (days * 24 * 60 * 60 * 1000));
        // 将日期转换为UTC字符串,这是Cookie expires属性要求的格式
        expires = "; expires=" + date.toUTCString();
    }
    // 构造Cookie字符串,path=/ 是一个很重要的点,确保Cookie在整个网站都可用
    document.cookie = name + "=" + (value || "") + expires + "; path=/";
}

// 示例:设置一个名为 'username',值为 'Alice',7天后过期的Cookie
setCookie("username", "Alice", 7);

// 示例:设置一个会话Cookie(不设置过期时间,浏览器关闭时失效)
setCookie("session_id", "some_unique_id");

// 示例:让一个Cookie立即过期(等同于删除),可以通过设置一个过去的日期
setCookie("username", "", -1); // 传入-1天,使其立即过期
登录后复制

这里有一个很重要的点是

path=/
登录后复制
。如果你不指定
path
登录后复制
属性,Cookie默认只对当前路径及其子路径有效。这可能导致你在其他页面无法访问到你期望的Cookie,从而造成一些调试上的困扰。在实际生产环境中,你可能还需要考虑
secure
登录后复制
(仅HTTPS传输)和
SameSite
登录后复制
(CSRF保护)等属性,它们对Cookie的安全性至关重要。

立即学习Java免费学习笔记(深入)”;

为什么Cookie的过期时间设置总是让人头疼?

说实话,Cookie的过期时间设置,尤其是通过

document.cookie
登录后复制
直接操作时,确实常常让人感到有些头疼。这主要有几个原因。首先,日期格式的严格要求是最大的一个坑。
expires
登录后复制
属性只认GMT/UTC格式的日期字符串,如果你不小心用了本地时间或者其他格式,Cookie可能根本不会按你预期的那样工作。
Date.prototype.toUTCString()
登录后复制
就是为了解决这个问题的,但初学者很容易忽略。

其次,时间计算本身就有点绕。我们需要把“几天后”转换成具体的毫秒数,再加到当前时间戳上,然后转换成日期对象,最后再格式化。这一系列操作,任何一步出错都可能导致Cookie失效时间不对。

再者,Cookie的生命周期不仅仅受

expires
登录后复制
(或
max-age
登录后复制
,虽然
expires
登录后复制
更老旧但兼容性广)影响,还和
path
登录后复制
domain
登录后复制
这些属性息息相关。如果一个Cookie的
path
登录后复制
domain
登录后复制
设置不正确,即使过期时间是对的,它也可能无法在预期的页面或子域下被访问到,这无疑增加了问题的复杂性。有时候,你明明看到Cookie存在,但就是用不了,多半就是这些属性在作祟。

除了过期时间,还有哪些Cookie属性会影响其生命周期和可用性?

除了

expires
登录后复制
(或
max-age
登录后复制
),Cookie还有几个非常重要的属性,它们共同决定了一个Cookie的生命周期、作用范围以及安全性。理解这些属性对于有效地管理Cookie至关重要:

  • path
    登录后复制
    : 这个属性定义了Cookie在哪个路径下是可用的。比如,
    path=/
    登录后复制
    表示Cookie在整个网站的任何路径下都可用。如果设置为
    path=/app
    登录后复制
    ,那么Cookie只在
    /app
    登录后复制
    及其子路径下可用。这是一个常见的误区,很多时候Cookie无法访问就是因为
    path
    登录后复制
    设置不正确。
  • domain
    登录后复制
    :
    domain
    登录后复制
    属性指定了Cookie所属的域名。如果未指定,默认是设置该Cookie的当前主机名(不包含子域名)。如果指定了,比如
    domain=example.com
    登录后复制
    ,那么Cookie对
    example.com
    登录后复制
    及其所有子域名(如
    www.example.com
    登录后复制
    ,
    blog.example.com
    登录后复制
    )都可用。但值得注意的是,你只能为当前域或其父域设置Cookie,不能为其他域设置。
  • secure
    登录后复制
    : 这是一个布尔属性。如果设置了
    secure
    登录后复制
    ,那么Cookie只会在HTTPS连接下发送到服务器。这意味着在HTTP连接中,浏览器不会发送这个Cookie,从而增加了传输的安全性,防止敏感信息被窃听。
  • HttpOnly
    登录后复制
    : 如果设置了
    HttpOnly
    登录后复制
    ,那么JavaScript将无法通过
    document.cookie
    登录后复制
    API访问到这个Cookie。这个属性主要是为了防止跨站脚本攻击(XSS),即使攻击者成功注入了恶意脚本,也无法窃取到用户的Session Cookie。这是一个非常重要的安全特性。
  • SameSite
    登录后复制
    : 这是近年来非常重要的一个安全属性,用于防止跨站请求伪造(CSRF)攻击。它有三个值:
    • Lax
      登录后复制
      (默认值):在跨站请求中,只有GET请求且是顶级导航时(比如点击链接),才会发送Cookie。
    • Strict
      登录后复制
      :在所有跨站请求中都不发送Cookie。只有当请求是同站发起的,才会发送。
    • None
      登录后复制
      :在所有跨站请求中都发送Cookie,但必须同时设置
      secure
      登录后复制
      属性(即Cookie只能通过HTTPS发送)。

这些属性共同编织了一张复杂的网,决定了Cookie何时、何地以及如何被使用。

如何有效地“删除”一个已经设置的Cookie?

要有效地“删除”一个已经设置的Cookie,其实并没有一个直接的

deleteCookie
登录后复制
方法。我们采取的策略是:将目标Cookie的过期时间设置为一个过去的日期。这样,浏览器在下次检查Cookie时,发现它已经过期,就会自动将其移除。

删除Cookie的关键在于,你必须提供与原始Cookie完全匹配的

name
登录后复制
path
登录后复制
domain
登录后复制
属性。如果这些属性不匹配,你可能只是创建了一个新的、立即过期的Cookie,而原始的Cookie仍然存在。

function deleteCookie(name, path = "/", domain = "") {
    // 设置一个过去的日期,通常是1970年1月1日
    const pastDate = "Thu, 01 Jan 1970 00:00:00 UTC";

    let deleteString = name + "=; expires=" + pastDate + "; path=" + path;

    // 如果原始Cookie设置了domain,这里也必须匹配
    if (domain) {
        deleteString += "; domain=" + domain;
    }

    // 将构造好的字符串赋值给document.cookie
    document.cookie = deleteString;
}

// 示例:删除名为 'username' 的Cookie,假设它是在根路径 '/' 下设置的
deleteCookie("username");

// 示例:如果 'user_pref' Cookie是在 '/settings' 路径下设置的,你需要这样删除
// deleteCookie("user_pref", "/settings");

// 示例:如果 'analytics_id' Cookie是在 '.example.com' 域下设置的
// deleteCookie("analytics_id", "/", ".example.com");
登录后复制

这里需要特别强调的是

path
登录后复制
domain
登录后复制
的匹配问题。一个常见的错误是,当一个Cookie是在
/app
登录后复制
路径下设置的,你却尝试用
path=/
登录后复制
去删除它。这会导致删除失败,因为浏览器会认为它们是两个不同的Cookie。因此,在删除Cookie时,一定要确保你提供的
path
登录后复制
domain
登录后复制
与原始Cookie设置时所用的值一致。如果不确定原始Cookie的
path
登录后复制
domain
登录后复制
,通常最安全的方式是尝试使用最广的范围(
path=/
登录后复制
和不指定
domain
登录后复制
或指定顶级域),但这并不总是奏效。在实际开发中,记录下你设置Cookie时的所有属性,以便后续精确删除,是一个很好的习惯。

以上就是怎么使用JavaScript操作Cookie的过期时间?的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习
PHP中文网抖音号
发现有趣的

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号