JS操作Cookie详解与实用技巧
时间:2025-08-01 20:00:48 282浏览 收藏
还在为JavaScript操作Cookie的各种问题头疼吗?本文为你提供一份全面的JS操作Cookie攻略,助你轻松驾驭浏览器的“小饼干”。文章深入浅出地讲解了如何使用`document.cookie`属性进行Cookie的设置、读取和删除,并着重强调了编码问题的重要性,分享了使用`encodeURIComponent`和`decodeURIComponent`处理特殊字符的实用技巧。同时,本文还深入探讨了Cookie的安全性问题,提出了避免存储敏感信息、设置HttpOnly和Secure标志等安全建议,并介绍了在React、Vue、Angular等主流框架中使用`js-cookie`、`vue-cookies`、`ngx-cookie-service`等库来简化Cookie操作的方法,让你在不同框架下都能得心应手,提升开发效率和代码可靠性。
解决JavaScript操作Cookie时的编码问题需在设置时使用encodeURIComponent编码,读取时使用decodeURIComponent解码,以避免特殊字符导致值被截断或解析错误;2. 确保JavaScript Cookie安全的方法包括避免存储敏感信息、通过服务器端设置HttpOnly和Secure标志防止XSS和中间人攻击、设置合理过期时间并验证来源,更安全的方式是使用服务器端Session;3. 在React、Vue、Angular等框架中可分别使用js-cookie、vue-cookies、ngx-cookie-service等库简化Cookie操作,这些库提供统一API并自动处理编码与部分安全问题,提升开发效率与可靠性。
直接操作JavaScript中的Cookie,其实就像在浏览器的“小饼干罐”里存取数据一样。虽然简单,但也有些需要注意的地方。

解决方案
JavaScript操作Cookie主要通过document.cookie
属性。这个属性允许你读取、设置和删除Cookie。

- 设置Cookie:
document.cookie = "username=John Doe; expires=Thu, 18 Dec 2024 12:00:00 UTC; path=/";
这条语句会创建一个名为username
的Cookie,值为John Doe
,过期时间设置为2024年12月18日,作用路径为根目录/
。注意,expires
指定过期日期,path
指定Cookie生效的路径。如果不设置expires
,Cookie会在浏览器会话结束时失效(会话Cookie)。如果不设置path
,Cookie默认只在当前目录及其子目录下生效。
- 读取Cookie:
let cookies = document.cookie; console.log(cookies); // 输出类似 "username=John Doe; otherCookie=value" 的字符串
document.cookie
返回一个包含所有Cookie的字符串,每个Cookie之间用分号和空格分隔。你需要自己解析这个字符串来获取特定Cookie的值。

- 解析Cookie:
function getCookie(name) { let cookieName = name + "="; let decodedCookie = decodeURIComponent(document.cookie); let ca = decodedCookie.split(';'); for(let i = 0; i这段代码定义了一个
getCookie
函数,用于根据Cookie的名称获取其值。它首先解码Cookie字符串,然后分割成单个Cookie,最后查找匹配的Cookie并返回其值。
- 删除Cookie:
删除Cookie实际上是将Cookie的过期时间设置为过去的时间。
document.cookie = "username=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/;";这条语句将
username
Cookie的过期时间设置为1970年1月1日,从而使其立即失效。同样,path
也必须与设置Cookie时使用的path
一致,否则Cookie不会被正确删除。JavaScript操作Cookie的局限性是Cookie的大小限制(通常为4KB)和安全性问题。对于更复杂的数据存储,可以考虑使用
localStorage
或sessionStorage
。如何解决JavaScript操作Cookie时的编码问题?
Cookie的值在存储时需要进行编码,读取时需要解码,以避免特殊字符引起的错误。通常使用
encodeURIComponent
和decodeURIComponent
函数。// 设置Cookie时编码 document.cookie = "itemName=" + encodeURIComponent("商品名称包含特殊字符") + "; path=/"; // 读取Cookie时解码 let itemName = decodeURIComponent(getCookie("itemName")); console.log(itemName); // 输出 "商品名称包含特殊字符"不进行编码解码,可能会导致Cookie值被截断,或者无法正确解析。
如何确保JavaScript Cookie的安全性?
Cookie的安全性是一个重要问题,尤其是存储敏感信息时。以下是一些建议:
- 不要在Cookie中存储敏感信息: 尽量避免直接存储密码、信用卡信息等敏感数据。
- 使用
HttpOnly
标志: 设置HttpOnly
标志后,Cookie只能通过HTTP(S)协议访问,JavaScript无法读取,可以防止XSS攻击。 这个标志需要在服务器端设置,JavaScript无法直接设置。例如,在PHP中可以这样设置:setcookie("cookieName", "cookieValue", ["httponly" => true]);
- 使用
Secure
标志: 设置Secure
标志后,Cookie只能通过HTTPS协议传输,可以防止中间人攻击。同样需要在服务器端设置。- 设置合理的过期时间: 避免Cookie长期有效,减少被盗用的风险。
- 验证Cookie的来源: 在服务器端验证Cookie的来源,防止跨域攻击。
尽管如此,由于JavaScript可以操作Cookie,仍然存在一定的安全风险。更安全的选择是使用服务器端Session存储敏感信息。
如何在不同的JavaScript框架(如React、Vue、Angular)中使用Cookie?
虽然底层的Cookie操作都是基于
document.cookie
,但在不同的JavaScript框架中,通常会使用一些辅助库来简化Cookie的管理。
- React: 可以使用
js-cookie
库。import Cookies from 'js-cookie' Cookies.set('name', 'value', { expires: 7 }); // 设置Cookie,过期时间为7天 let value = Cookies.get('name'); // 获取Cookie Cookies.remove('name'); // 删除Cookie
- Vue: 可以使用
vue-cookies
插件。import VueCookies from 'vue-cookies' Vue.use(VueCookies) this.$cookies.set('name', 'value', '7d'); // 设置Cookie,过期时间为7天 let value = this.$cookies.get('name'); // 获取Cookie this.$cookies.remove('name'); // 删除Cookie
- Angular: 可以使用
ngx-cookie-service
。import { CookieService } from 'ngx-cookie-service'; constructor(private cookieService: CookieService) { } ngOnInit(): void { this.cookieService.set('name', 'value', 7); // 设置Cookie,过期时间为7天 let value = this.cookieService.get('name'); // 获取Cookie this.cookieService.delete('name'); // 删除Cookie }这些库或插件提供了更方便的API,可以更轻松地设置、读取和删除Cookie,并且通常会处理一些常见的编码和安全问题。选择哪个库取决于你的项目需求和个人偏好。
以上就是《JS操作Cookie详解与实用技巧》的详细内容,更多关于JavaScript,框架,编码,cookie,安全性的资料请关注golang学习网公众号!
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
473 收藏
-
260 收藏
-
286 收藏
-
412 收藏
-
245 收藏
-
495 收藏
-
235 收藏
-
129 收藏
-
105 收藏
-
281 收藏
-
489 收藏
-
207 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 542次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 511次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 498次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 484次学习