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 做不到的。