萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery Cookie 插件設置過期時間:expires 參數正確寫法、Date 對象陷阱、單位換算

正確設置過期時間

var expireDate = new Date();
expireDate.setTime(expireDate.getTime() + (60 * 60 * 1000)); // 1小時 = 60分×60秒×1000毫秒

$.cookie('__cookie__', 'helloworld', {
  path: '/',           // 作用域路徑
  expires: expireDate  // 必須傳 Date 對象,不能傳數字/字符串
});

常見錯誤與避坑

快捷工具函數

function setCookie(name, value, minutes, path) {
  var d = new Date();
  d.setTime(d.getTime() + (minutes * 60 * 1000));
  $.cookie(name, value, { expires: d, path: path || '/' });
}

function getCookie(name) {
  return $.cookie(name);
}

function delCookie(name, path) {
  $.cookie(name, null, { expires: -1, path: path || '/' }); // expires -1 即刪除
}

原生 document.cookie 等效寫法(無依賴)

function setCookieNative(name, value, minutes, path, domain) {
  var d = new Date();
  d.setTime(d.getTime() + minutes * 60 * 1000);
  var cookie = encodeURIComponent(name) + '=' + encodeURIComponent(value)
    + '; expires=' + d.toUTCString()
    + '; path=' + (path || '/');
  if (domain) cookie += '; domain=' + domain;
  document.cookie = cookie;
}

最佳實踐清單

  1. 統一使用 **UTC 時間字符串**(toUTCString())而非本地時間
  2. 路徑 path 盡量精確,避免污染同域其他應用
  3. 敏感 Cookie 必加 Secure; HttpOnly; SameSite=Lax(需後端設置,前端 JS 無法設置 HttpOnly)
  4. 封裝統一 Cookie 工具模塊,業務代碼勿直接操作 $.cookie
copyright © 萬盛學電腦網 all rights reserved
錯誤寫法問題正確寫法
expires: 60數字被當作天數(插件舊版行為不一)傳 Date 對象或天數整數(文檔說明以插件版本為準)
new date() / settime()JS 大小寫敏感,報錯 date is not definednew Date()、setTime()、getTime()
expires: '1h'字符串無效插件不支援字符串解析,需自行換算