javascript的Cookie如何操作?【教程】

星晨姑娘_9445

星晨姑娘_9445

2026-01-17

767人浏览

原创

JavaScript 无内置 Cookie API,需手动操作 document.cookie 字符串,必须正确编码值、设置 path=/、Secure、expires 等属性,读取需正则解析,删除须完全匹配原 path/domain 并设过期时间。

javascript的cookie如何操作?【教程】

JavaScript 本身没有内置的 Cookie 类或高级 API,所有操作都依赖原生的 document.cookie 字符串读写,这意味着你得自己解析、编码、设置过期时间、作用域等——稍不注意就会漏掉 path、domain 或 Secure 标志,导致 Cookie 写不进、读不到、或被浏览器拒绝。

如何安全地设置一个带属性的 Cookie

直接拼接字符串极易出错,比如忘记 encodeURIComponent() 导致特殊字符(如空格、分号)截断值,或漏写 path=/ 导致子路径下无法读取。

  • 必须对 value 使用 encodeURIComponent(),否则 =、;、空格等会破坏格式
  • path=/ 是最常用且推荐的默认值,否则默认为当前路径(比如 /user/profile 下设的 Cookie 在 / 下就读不到)
  • 如果站点启用了 HTTPS,务必加上 Secure;若需跨子域共享(如 a.example.com 和 b.example.com),才加 Domain=.example.com
  • 有效期用 expires(UTC 时间字符串)比 max-age 兼容性更好(IE 不支持 max-age)
function setCookie(name, value, days = 7) {
  const date = new Date();
  date.setTime(date.getTime() + days * 24 * 60 * 60 * 1000);
  const expires = date.toUTCString();
  document.cookie = `${encodeURIComponent(name)}=${encodeURIComponent(value)}; expires=${expires}; path=/; Secure; SameSite=Lax`;
}

为什么 document.cookie 读出来是字符串而不是对象

因为 document.cookie 是一个“getter/setter”伪属性:读取时返回一个分号分隔的键值对字符串(如 "a=1; b=2; c=hello%20world"),不自动解析,也不暴露原始属性(expires、HttpOnly 等均不可见)。

  • HttpOnly Cookie 完全不可读——JS 访问 document.cookie 时会被静默过滤掉,这是安全机制,不是 bug
  • 多个同名 Cookie(不同 path 或 domain)会同时出现在字符串中,但浏览器只返回**当前路径匹配且未过期**的那一条(按写入顺序?实际由浏览器决定,不可依赖)
  • 不能通过 document.cookie = "a=" 删除 Cookie,必须设 expires 为过去时间

如何可靠地读取指定 Cookie 的值

手动解析 document.cookie 字符串是最轻量、无依赖的做法,但要注意边界匹配(避免 name= 匹配到 namename=)和解码。

HISUI 前端框架开发指南(IRIS版)
HISUI 前端框架开发指南(IRIS版)

HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库,专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。 涵盖 40 个组件的官方文档参考,支持声明式与编程式两种初始化方式,提供 $cm/$m 数据访问方法。

下载
function getCookie(name) {
  const match = document.cookie.match(new RegExp(`(^|;)\s*${encodeURIComponent(name)}=([^;]*)`));
  return match ? decodeURIComponent(match[2]) : null;
}
  • 正则中 (^|;) 确保匹配键的开头(行首或分号后),\s* 吃掉可能的空格
  • 即使服务端写了 SameSite=None; Secure,JS 仍能读——只要没标 HttpOnly
  • 不要用 split(';') + indexOf,遇到值含分号(虽少见但合法)就崩

删除 Cookie 的正确姿势是什么

没有 deleteCookie() 方法。删除 = 覆盖写入一个已过期的同名 Cookie,且 path 和 domain 必须与原 Cookie 完全一致,否则旧 Cookie 仍残留。

  • 只设 expires 不够,必须带上和当初设置时一模一样的 path(常见坑:当初没写 path,默认是当前路径,删时却写了 path=/ → 删不掉)
  • 如果原 Cookie 有 Domain=.example.com,删除时也必须带上,否则只清除了当前主机名下的副本
  • 可以省略 value,但最好设为空字符串,更明确
function deleteCookie(name, path = '/', domain = '') {
  document.cookie = `${encodeURIComponent(name)}=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=${path}${domain ? '; domain=' + domain : ''}`;
}

真正麻烦的从来不是语法,而是每个属性都得对齐、每个字符都要编码、每次读写都得防注入——这也是为什么现代项目基本用 localStorage 或服务端 session + JWT 替代 Cookie 做前端状态管理。如果非用 Cookie,建议封装成小函数并统一管理 path 和 Secure 策略,别在业务代码里零散拼字符串。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
cookie
cookie

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

2023.06.30

12959

10

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

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

2023.11.23

1346

5

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

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

2024.02.23

884

5

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

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

2025.08.19

1986

14

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

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

2023.10.17

580

4

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

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

2023.10.18

876

5

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

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

2025.08.19

1986

14

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

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

2023.08.03

1938

5

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

3204

5

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12.5万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.8万人学习