Cookie 的操作細節不少:名稱與值要編碼、過期時間要換算、路徑與網域要指定。把這些細節收進三個函式裡,之後任何頁面都能一行搞定。以下是一份可直接取用的實作。
參數包含名稱、值、有效時間(以小時為單位)、路徑、網域與安全性旗標。
/*
* 設置 Cookie
* name:cookie 的鍵 value:值
* expires:有效時間(小時) path:可訪問路徑
* domain:可訪問主機名 secure:是否僅透過 HTTPS 傳輸
*/
function setCookie(name, value, expires, path, domain, secure) {
var str = name + "=" + escape(value); // 名稱/值對,值需編碼
if (expires > 0) {
var date = new Date();
date.setTime(date.getTime() + expires * 3600 * 1000);
str += "; expires=" + date.toGMTString();
}
if (path) str += "; path=" + path;
if (domain) str += "; domain=" + domain;
if (secure) str += "; secure";
document.cookie = str;
}
/*
* 獲得 Cookie
* cookie_name:cookie 的鍵
*/
function getCookie(cookie_name) {
var value = null;
var allcookies = document.cookie;
var cookie_pos = allcookies.indexOf(cookie_name);
if (cookie_pos != -1) {
// 把位置移到值的起點
cookie_pos += cookie_name.length + 1;
var cookie_end = allcookies.indexOf(";", cookie_pos);
if (cookie_end == -1) {
cookie_end = allcookies.length;
}
value = unescape(allcookies.substring(cookie_pos, cookie_end));
}
return value;
}
Cookie 沒有真正的 delete 方法,作法是把它設為立即過期。
/*
* 刪除 Cookie
* cookie_name:cookie 的鍵
*/
function delCookie(cookie_name) {
var exp = new Date();
exp.setTime(exp.getTime() - 1);
var value = getCookie(cookie_name);
if (value) {
document.cookie = cookie_name + "=" + value + ";expires=" + exp.toGMTString();
}
}
setCookie("userName", "hulk", 24, "/"); // 一天後過期,全站可用
var name = getCookie("userName");
delCookie("userName");
第一,getCookie 用 indexOf 尋找名稱時,可能誤命中前綴相同的 Cookie。例如要讀 user,卻先撞上 userName=xxx。較嚴謹的做法是先把 document.cookie 以 "; " 切成陣列,再用 split("=") 逐一比對完整名稱。
第二,escape() 與 unescape() 已被標準標示為避免使用,建議改用 encodeURIComponent() 與 decodeURIComponent(),後者對 UTF-8 中文的處理也更可靠。若要存放敏感資料,無論如何都不應直接寫入純文字的 Cookie。