瀏覽網站時,網站會在你的電腦寫入一個很小的文字檔,用來記錄使用者代號、偏好、造訪過的頁面、停留時間等資訊。下次再來時,網站讀取這些資料就能做出對應反應,例如顯示歡迎語、讓你不必重新輸入帳號密碼。就某種意義來說,cookie 等於是你在該網站上的身分證。
用原生 JavaScript 設定與讀取 cookie 相當繁瑣,得自己處理編碼、分號串接與過期時間格式。所幸 jQuery 有現成外掛可用,讓建立、讀取、刪除都縮短成一行。外掛可於 jQuery 官方外掛站下載。
建立一個名為 example、值為 foo 的 cookie:
$.cookie("example", "foo");
以天為單位設定過期時間,例如 10 天後失效:
$.cookie("example", "foo", { expires: 10 });
若需要更精細的控制,可直接傳入 Date 物件,例如一小時後過期:
var cookietime = new Date();
cookietime.setTime(cookietime.getTime() + (60 * 60 * 1000)); // 一小時
$.cookie("example", "foo", { expires: cookietime });
path 決定 cookie 的可用範圍。設為根目錄時,全站頁面都能讀到:
$.cookie("example", "foo", { path: "/" });
若只在後台使用,可限定路徑:
$.cookie("example", "foo", { path: "/admin" });
若不指定 path,cookie 的預設範圍會依目前頁面的所在目錄而定,這經常是「明明設了卻讀不到」的主因,實務上建議一律明確帶上 path。
alert($.cookie("example"));
把值設為 null 即可刪除:
$.cookie("example", null);
要注意的是,若把值設為空字串,並不會刪除 cookie,只是把內容清空,該筆資料仍然存在。