Cookie 是瀏覽器端最基礎的狀態保存手段。JavaScript 操作它並不難,但因為沒有現成的 API,所有事情都得靠字串處理完成,細節上容易出錯。以下把讀、寫、刪三件事整理成可直接取用的函式。
// 寫入 Cookie
function setCookie(name, value) {
var Days = 30;
var exp = new Date();
exp.setTime(exp.getTime() + Days * 24 * 60 * 60 * 1000);
document.cookie = name + "=" + escape(value) + ";expires=" + exp.toGMTString();
}
// 讀取 Cookie
function getCookie(name) {
var arr, reg = new RegExp("(^| )" + name + "=([^;]*)(;|$)");
if (arr = document.cookie.match(reg)) return unescape(arr[2]);
else return null;
}
// 刪除 Cookie
function delCookie(name) {
var exp = new Date();
exp.setTime(exp.getTime() - 1);
var cval = getCookie(name);
if (cval != null) document.cookie = name + "=" + cval + ";expires=" + exp.toGMTString();
}
使用方式很直觀:
setCookie("name", "hayden");
alert(getCookie("name"));
若不想把效期寫死,可以傳入一個帶單位前綴的字串,例如 s20 代表 20 秒、h12 代表 12 小時、d30 代表 30 天:
function setCookie(name, value, time) {
var strsec = getsec(time);
var exp = new Date();
exp.setTime(exp.getTime() + strsec * 1);
document.cookie = name + "=" + escape(value) + ";expires=" + exp.toGMTString();
}
function getsec(str) {
var str1 = str.substring(1, str.length) * 1;
var str2 = str.substring(0, 1);
if (str2 == "s") return str1 * 1000;
else if (str2 == "h") return str1 * 60 * 60 * 1000;
else if (str2 == "d") return str1 * 24 * 60 * 60 * 1000;
}
呼叫方式:
setCookie("name", "hayden", "s20"); // 20 秒後過期
setCookie("name", "hayden", "h12"); // 12 小時後過期
setCookie("name", "hayden", "d30"); // 30 天後過期
刪除的原理是「設定過去時間」。Cookie 沒有 delete 方法,只能把 expires 設成一個已經過去的時間點,讓瀏覽器自動判定它失效。
escape 與 encodeURI 的選擇。值裡若含分號、空白或中文,必須編碼後才能安全存入,否則會破壞 Cookie 的結構。escape 已被標準廢棄,現代寫法建議改用 encodeURIComponent,讀取時對應使用 decodeURIComponent。
名稱是大小寫敏感的,路徑與網域也會影響可見性。如果同一個名稱在不同路徑下寫入,會產生多個同名 Cookie,讀取時只會拿到其中一個,這是很常見的困惑來源。若需要明確控制,可在設定時加上 path 與 domain 參數。
注意容量與敏感資料。單一 Cookie 的上限約 4KB,且每次請求都會隨標頭送出,不適合存放大量資料。更重要的是——絕不要把密碼、權杖這類敏感資訊明文放進 Cookie。若確有必要,務必加上 Secure 與 HttpOnly 旗標,前者要求僅透過 HTTPS 傳輸,後者則禁止 JavaScript 讀取,能有效降低 XSS 造成的信息外洩風險。
最後提一句現代替代方案:如果只是要在同一個瀏覽器工作階段中暫存資料,localStorage 與 sessionStorage 的 API 乾淨得多,容量也大得多。Cookie 的價值在於它會自動隨請求送往伺服器,適合承載身分識別這類需求;純粹的用戶端暫存,則沒有必要繞遠路。