原生 JavaScript 操作 cookie 得自己組字串、算 GMT 時間、處理編碼,寫起來相當繁瑣。有了 cookie 外掛之後,設定與刪除各只要一行:
$.cookie("username", str_username, { expires: 7 }); // 存一個 7 天後過期的 cookie
$.cookie("username", "", { expires: -1 }); // 刪除這個 cookie
刪除 cookie 的原理其實是「讓它過期」。瀏覽器並沒有提供刪除指令,所以做法是設定一個已經過去的到期時間,瀏覽器收到後便會把它清掉。把 expires 設為 -1,就是告訴外掛把到期日算在一天前,於是 cookie 立刻失效。
如果不用外掛,等價的原始寫法大致如下:
document.cookie = "username=; expires=" + new Date(0).toUTCString() + "; path=/";
這裡的 path 特別重要,稍後會談到。
path 決定 cookie 的可見範圍。若不指定,預設只在當前目錄及其子目錄可讀。也就是說,在 /php/ 下設定的 cookie,跑到 /sj/ 就讀不到了。要讓整站都能存取,必須明確寫成 path=/。
domain 則決定跨子網域的可見性。若只在 www.example.com 上設定且未指定 domain,那麼 blog.example.com 是讀不到的。要讓所有子網域共用,得把 domain 設為 .example.com。
這兩個參數最麻煩的地方在於:刪除時必須用與設定時完全相同的 path 與 domain,否則瀏覽器會認為你要刪的是另一個 cookie,刪不掉也不會報錯。這是許多人「明明寫了刪除程式碼,cookie 卻還在」的主因。
外掛本身不含讀取方法,取值用 $.cookie("name") 即可,回傳字串;若不存在則是 undefined,判斷時記得用嚴格比較。
最後提醒一個觀念:cookie 存在使用者端,內容明文可讀,千萬不要拿來存密碼、權杖或任何敏感資料。它適合放的是 UI 偏好、是否看過引導頁這類無關安全的狀態。