javascript操作cookie需手动处理编码、路径、域名和过期时间:设置时用encodeuricomponent()编码并指定expires、path、domain;获取时需split('; ')后解码;删除须设过去时间且路径域名严格匹配;推荐使用js-cookie库避免踩坑。

JavaScript 通过 document.cookie 接口读写 Cookie,但这个接口是字符串形式的“伪 API”——它不直接提供 set/get/delete 方法,需要手动解析和构造。掌握正确写法才能避免乱码、失效或跨路径不可见等问题。
设置 Cookie:必须指定过期时间和路径
仅写 document.cookie = "name=value" 会创建一个会话级 Cookie(关闭浏览器即消失),且只在当前页面路径下有效。生产环境应显式设置 expires 和 path:
- 用
encodeURIComponent()编码值,防止空格、分号等特殊字符破坏格式 -
expires必须是 UTC 时间字符串(推荐toUTCString(),不是toGMTString(),后者已过时) -
path=/确保全站可访问;如只需当前目录,可设为path=/admin/ - 如需跨子域共享(如 a.example.com 和 b.example.com),加上
domain=.example.com
示例函数:
function setCookie(name, value, days = 7, path = '/', domain = '') {
const date = new Date();
date.setTime(date.getTime() + days * 24 * 60 * 60 * 1000);
let cookieStr = `${name}=${encodeURIComponent(value)}; expires=${date.toUTCString()}; path=${path}`;
if (domain) cookieStr += `; domain=${domain}`;
document.cookie = cookieStr;
}
获取 Cookie:按名称精确提取,注意空格和编码
document.cookie 返回的是形如 "a=1; b=2%20test; c=%7B%22id%22%3A1%7D" 的字符串,各键值对以分号+空格分隔。直接 .split(';') 容易因空格漏匹配。
- 推荐用
.split('; ')(带空格)再遍历,或用正则精准匹配 - 务必用
decodeURIComponent()解码,否则中文或 JSON 会变成乱码 - 注意名称边界:匹配
"name="开头,避免username误匹配name
简洁写法:
function getCookie(name) {
const cookies = document.cookie.split('; ');
for (const cookie of cookies) {
const [n, v] = cookie.split('=');
if (n === name) return decodeURIComponent(v);
}
return null;
}
删除 Cookie:不是清空值,而是让其过期
写 document.cookie = "name=" 或 document.cookie = "name=; expires=..." 但时间写错,都可能删不掉。关键点:
- 必须将
expires设为**过去的时间**(如 1970 年) - 路径(
path)和域名(domain)必须与设置时完全一致,否则无法覆盖 - 安全起见,删除时最好复用原设置参数,或统一用
path=/
安全删除函数:
function deleteCookie(name, path = '/', domain = '') {
const date = new Date(0); // 1970-01-01
let cookieStr = `${name}=; expires=${date.toUTCString()}; path=${path}`;
if (domain) cookieStr += `; domain=${domain}`;
document.cookie = cookieStr;
}
进阶建议:用成熟库省去踩坑
手写容易遗漏编码、路径、域或时区问题。推荐轻量库 js-cookie(仅 2KB):
- 设置:
Cookies.set('token', 'abc', { expires: 7, path: '/' }) - 读取:
Cookies.get('token')(自动解码) - 删除:
Cookies.remove('token')(自动匹配路径) - 支持 JSON 存储:
Cookies.set('user', { id: 1, name: '张三' })
引入方式:<script src="https://cdn.jsdelivr.net/npm/js-cookie@3/dist/js.cookie.min.js"></script>
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











