在早期的前端開發裡,document.cookie 幾乎是保存用戶狀態的唯一手段。它看起來像一個普通屬性,實際行為卻和一般屬性差很多,也正因如此成為許多人踩坑的起點。本文把它的核心用法完整梳理一遍。
設定 cookie 只需要對 document.cookie 賦值:
document.cookie = "userId=828";
若要一次寫入多組名/值對,用「分號 + 空格」隔開即可:
document.cookie = "userId=828; userName=hulk";
需要注意的是,cookie 的名稱與值中不能直接出現分號(;)、逗號(,)、等號(=)與空格這類保留字元。名稱部分通常是我們自己定義的,容易避開;但值往往來自用戶輸入或動態資料,無法事先保證「乾淨」。
面對不可控的值,標準做法是先用 escape() 編碼,它會把特殊符號轉成十六進位表示,例如空格會變成 %20,這樣就能安全地放進 cookie 值裡,同時也能避免中文亂碼:
document.cookie = "str=" + escape("I love ajax");
// 實際寫入的內容相當於
document.cookie = "str=I%20love%20ajax";
取值時,再用 unescape() 還原成原本的字串即可。
直覺上我們會以為第二次賦值會蓋掉第一次,實際不然:
document.cookie = "userId=828";
document.cookie = "userName=hulk";
執行完這兩行,瀏覽器會同時保留 userId 與 userName 兩個 cookie。也就是說,對 document.cookie 賦值比較接近這樣的語意:
document.addCookie("userId=828");
document.addCookie("userName=hulk");
瀏覽器內部正是以這種「逐筆設定」的方式處理。因此,想修改某個既有 cookie,只要用相同名稱重新賦值即可:
document.cookie = "userId=929"; // userId 被更新為 929
讀取同樣透過 document.cookie:
var strCookie = document.cookie;
得到的是一個以分號分隔的字串,包含該域名下所有 cookie。這裡有個關鍵限制:無法指定名稱只取單一值,一次就會把全部 cookie 吐回來,必須自己解析字串。例如取出 userId:
function getCookie(name) {
var pairs = document.cookie.split("; ");
for (var i = 0; i < pairs.length; i++) {
var arr = pairs[i].split("=");
if (arr[0] == name) return unescape(arr[1]);
}
return "";
}
核心技巧仍是字串與陣列操作:先 split 成陣列,再逐一比對名稱。
到目前为止的 cookie 都是「單一工作階段(session)cookie」——它們只存在記憶體中,不會落地成檔案,瀏覽器一關就消失。若要長期保存(例如記住登入狀態),加上 expires:
document.cookie = "userId=828; expires=GMT_String";
其中 GMT_String 是 GMT 格式的時間字串。想讓 cookie 在 10 天後失效:
var date = new Date();
date.setTime(date.getTime() + 10 * 24 * 60 * 60 * 1000);
document.cookie = "userId=828; expires=" + date.toGMTString();
沒有專用的 delete 方法,把過期時間設成一個已經過去的那一刻即可:
var date = new Date();
date.setTime(date.getTime() - 1000);
document.cookie = "userId=828; expires=" + date.toGMTString();
預設情況下,某頁面建立的 cookie,同目錄的其他頁面都能讀取,子目錄也包含在內。例如在 www.xxxx.com/html/a.html 建立的 cookie,/html/b.html 與 /html/some/c.html 都可以存取,但 www.xxxx.com/d.html 不行。
要自訂範圍,加上 path 參數:
document.cookie = "name=value; path=cookieDir";
document.cookie = "userId=320; path=/shop"; // 僅 shop 目錄可用
document.cookie = "userId=320; path=/"; // 全站可用
主機(host)指的是同一個網域下的不同伺服器,例如 www.google.com 與 gmail.google.com。預設情況下,一個主機設定的 cookie 無法被另一個主機讀取,但可以透過 domain 放寬:
document.cookie = "name=value; domain=cookieDomain";
document.cookie = "name=value; domain=.google.com"; // google.com 下所有主機共用
cookie 的處理流程固定又繁瑣,實務上一定會抽成函式重用。常見的三個操作如下。
接收名稱、值與「幾小時後過期」。約定 expiresHours 為 0 時不設定過期時間,也就是關閉瀏覽器即失效。
回傳指定名稱的值,不存在則回傳空字串(實作如第四節所示)。
把該名稱的過期時間設為過去,等於刪除。
把這三者包成一個 CookieClass 或工具物件,後續所有頁面都能直接取用,不必每次重寫解析邏輯。