Cookie 是儲存在客戶端的一種資料形式,常用於做狀態保持,例如記住登入狀態或使用者偏好。JavaScript 可以透過 document.cookie 來操作 Cookie。本文完整說明如何設定、讀取與刪除 Cookie,並附上可直接使用的範例。
a. 不設過期時間(此為工作階段 Cookie,關閉瀏覽器即失效):
function setCookie(name, value) {
document.cookie = name + '=' + escape(value);
}
b. 固定過期時間(例如 30 天):
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();
}
c. 自訂過期時間(以 s/h/d 為單位,如 "20s"、"12h"、"30d"):
function setCookie(name, value, time) {
var msec = getMsec(time); // 轉為毫秒
var exp = new Date();
exp.setTime(exp.getTime() + msec * 1);
document.cookie = name + "=" + escape(value) + ";expires=" + exp.toGMTString();
}
// 將 "20s"/"12h"/"30d" 之類字串轉為毫秒
function getMsec(DateStr) {
var timeNum = DateStr.substring(0, DateStr.length - 1) * 1; // 數字部分
var timeStr = DateStr.substring(DateStr.length - 1); // 單位部分
if (timeStr == "s") return timeNum * 1000;
else if (timeStr == "h") return timeNum * 60 * 60 * 1000;
else if (timeStr == "d") return timeNum * 24 * 60 * 60 * 1000;
}
以正規表達式從 document.cookie 中比對並取出指定名稱的值:
function getCookie(name) {
var arr, reg = new RegExp("(^| )" + name + "=([^;]*)(;|$)");
if (arr = document.cookie.match(reg)) {
return unescape(arr[2]);
} else {
return null;
}
}
刪除的做法是把過期時間設為過去(等於立即過期):
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")); // hayden
以上涵蓋了以 JavaScript 操作 Cookie 的三大基本動作。掌握了設定、讀取與刪除,就能靈活運用 Cookie 來實作各種狀態保持的功能。提醒您,Cookie 會明文儲存在使用者端,切勿用來存放敏感資訊。