DIV CSS 佈局教程網

原生 JavaScript 操作 Cookie:setCookie、getCookie、DelCookie 三步封裝
編輯:關於JavaScript     

JavaScript 沒有內建的 Cookie API,所有操作都得透過 document.cookie 這個字串屬性完成。麻煩的是:讀取時它回傳的是「所有 cookie 用分號串成的一長串」,寫入時又要自己拼 expires、path、domain。直接寫很容易出錯,所以實務上一定會包成函式。

下面是一個簡潔又好用的封裝:

完整程式碼

Cookie = {
  setCookie: function (name, val) {
    var exp = new Date();
    exp.setDate(exp.getDate() + 600 * 1000);
    document.cookie = name + "=" + escape(val) + ";expires=" + exp.toGMTString();
  },

  DelCookie: function (name) {
    document.cookie = name + "=;expires=" + (new Date(0)).toGMTString();
  },

  getCookie: function (name) {
    var cookieArray = document.cookie.match(new RegExp("(^| )" + name + "=([^;]*)(;|$)"));
    if (cookieArray != null) return unescape(cookieArray[2]);
    else return null;
  }
}

三個方法各在解什麼

setCookie(name, val)——寫入。用 escape() 編碼值(避免值裡有分號、等號把格式打壞),再拼上 expires 指定過期時間。

getCookie(name)——讀取。這是全篇最精妙的地方:用正則 (^| )name=([^;]*)(;|$) 從長字串裡精準抓出目標 cookie。(^| ) 確保 name 前面是字串開頭或空格(cookie 之間用 "; " 分隔),避免 uid 誤抓到 myuid;([^;]*) 用否定字元集抓到分號為止;(;|$) 收尾。找不到時回傳 null 而非空字串,讓呼叫端能用 if (Cookie.getCookie('x')) 清楚判斷。

DelCookie(name)——刪除。Cookie 沒有 delete 方法,標準做法是把過期時間設成 1970 年(new Date(0) 就是 Unix epoch),瀏覽器看到已過期就直接丟掉。

幾個實務上要注意的地方

那個 600 * 1000 有問題。 setDate() 接受的是「日」,不是毫秒。getDate() + 600 * 1000 等於把日期往後推了六十萬天,實務上應寫成 exp.setDate(exp.getDate() + 7)(7 天)或用 exp.setTime(exp.getTime() + 7 * 24 * 3600 * 1000)。這是原始碼裡的一個 bug,值得提出來。

escape() 已不建議使用。 它不會編碼 + 等字元,且對非 ASCII 的處理不符合 UTF-8 標準。今天應改用 encodeURIComponent() 與 decodeURIComponent()。

樣式屬性用 toGMTString()。 新方法應改用 toUTCString(),兩者效果相同但後者是標準名稱。

别忘了 path 與 SameSite。 若不指定 path,cookie 只在當前路徑下有效;預設值在不同瀏覽器間曾有差異,實務上建議明確寫上 ;path=/。另外,現代瀏覽器基於隱私考量會加上 SameSite=Lax 限制跨站傳送,需要時要顯式設定。

如果今天要寫同樣的功能,更推薦直接用 Storage API:localStorage 適合長期保存、sessionStorage 適合會話期間,兩者 API 乾淨(setItem / getItem / removeItem)、容量更大、也不會每次請求都附在 HTTP header 上送出來。Cookie 則仍舊是身份驗證與伺服器端會話的首選,因為它會自動隨請求傳送,這是 Storage 做不到的。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved