0

0

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

幻影之瞳

幻影之瞳

发布时间:2025-09-20 16:28:01

|

764人浏览过

|

来源于php中文网

原创

答案: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失效时间不对。

唱鸭
唱鸭

音乐创作全流程的AI自动作曲工具,集 AI 辅助作词、AI 自动作曲、编曲、混音于一体

下载

再者,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时的所有属性,以便后续精确删除,是一个很好的习惯。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
cookie
cookie

Cookie 是一种在用户计算机上存储小型文本文件的技术,用于在用户与网站进行交互时收集和存储有关用户的信息。当用户访问一个网站时,网站会将一个包含特定信息的 Cookie 文件发送到用户的浏览器,浏览器会将该 Cookie 存储在用户的计算机上。之后,当用户再次访问该网站时,浏览器会向服务器发送 Cookie,服务器可以根据 Cookie 中的信息来识别用户、跟踪用户行为等。

6427

2023.06.30

document.cookie获取不到怎么解决
document.cookie获取不到怎么解决

document.cookie获取不到的解决办法:1、浏览器的隐私设置;2、Same-origin policy;3、HTTPOnly Cookie;4、JavaScript代码错误;5、Cookie不存在或过期等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

346

2023.11.23

阻止所有cookie什么意思
阻止所有cookie什么意思

阻止所有cookie意味着在浏览器中禁止接受和存储网站发送的cookie。阻止所有cookie可能会影响许多网站的使用体验,因为许多网站使用cookie来提供个性化服务、存储用户信息或跟踪用户行为。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

411

2024.02.23

cookie与session的区别
cookie与session的区别

本专题整合了cookie与session的区别和使用方法等相关内容,阅读专题下面的文章了解更详细的内容。

91

2025.08.19

session失效的原因
session失效的原因

session失效的原因有会话超时、会话数量限制、会话完整性检查、服务器重启、浏览器或设备问题等等。详细介绍:1、会话超时:服务器为Session设置了一个默认的超时时间,当用户在一段时间内没有与服务器交互时,Session将自动失效;2、会话数量限制:服务器为每个用户的Session数量设置了一个限制,当用户创建的Session数量超过这个限制时,最新的会覆盖最早的等等。

315

2023.10.17

session失效解决方法
session失效解决方法

session失效通常是由于 session 的生存时间过期或者服务器关闭导致的。其解决办法:1、延长session的生存时间;2、使用持久化存储;3、使用cookie;4、异步更新session;5、使用会话管理中间件。

748

2023.10.18

cookie与session的区别
cookie与session的区别

本专题整合了cookie与session的区别和使用方法等相关内容,阅读专题下面的文章了解更详细的内容。

91

2025.08.19

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

298

2023.08.03

Python 自然语言处理(NLP)基础与实战
Python 自然语言处理(NLP)基础与实战

本专题系统讲解 Python 在自然语言处理(NLP)领域的基础方法与实战应用,涵盖文本预处理(分词、去停用词)、词性标注、命名实体识别、关键词提取、情感分析,以及常用 NLP 库(NLTK、spaCy)的核心用法。通过真实文本案例,帮助学习者掌握 使用 Python 进行文本分析与语言数据处理的完整流程,适用于内容分析、舆情监测与智能文本应用场景。

10

2026.01.27

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
php注册登录系统开发实战
php注册登录系统开发实战

共10课时 | 13.5万人学习

PHP基于Cookie的购物车模块设计
PHP基于Cookie的购物车模块设计

共10课时 | 10.7万人学习

第三期培训_PHP开发
第三期培训_PHP开发

共116课时 | 26.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

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