先前我們曾用一個不變的框架來存放購物車資料,藉此模擬全域變數。但商品頁不斷變化,這種做法並不嚴謹——例如在導覽框架頁面上按右鍵選「重新整理」,所有 JavaScript 變數就全丟了。真正跨頁面的全域變數,需要另一種機制:Cookie。
Cookie 並非 JavaScript 本身的性質,而是瀏覽器提供的一種機制:瀏覽器把 document 物件的 cookie 屬性開放給 JavaScript 控制。
實際上 Cookie 是存於使用者硬碟的小檔案,通常對應一個網域;當瀏覽器再次造訪該網域時,這個 Cookie 便會被帶上。因此 Cookie 可以跨越同一網域下的多個網頁,但無法跨網域使用。不同瀏覽器的實作細節有差,性質則一致——例如在 Windows XP 中,Cookie 存放於 Documents and Settings\userName\Cookies\ 資料夾,命名格式通常為 userName@domain.txt。
每個 Cookie 都是一個名/值對,直接賦值給 document.cookie 即可:
document.cookie = "userId=828";
要一次存多組,用分號加空格隔開:
document.cookie = "userId=828; userName=hulk";
名稱與值中不可使用分號(;)、逗號(,)、等號(=)與空格。名稱通常可控,但值往往無法預期,因此建議用 escape() 編碼——它會把特殊符號轉為十六進位(例如空格變成 %20),同時也能避免中文亂碼:
document.cookie = "str=" + escape("I love ajax");
// 等效於 document.cookie = "str=I%20love%20ajax";
取出時則要用 unescape() 解碼還原。
它看起來像一般屬性,但連續賦值並不會互相覆蓋:
document.cookie = "userId=828"; document.cookie = "userName=hulk";
執行後瀏覽器會同時保留兩個 Cookie。與其說是賦值,不如想像成在呼叫:
document.addCookie("userId=828");
document.addCookie("userName=hulk");
若要修改既有 Cookie,重新賦同名值即可:
document.cookie = "userId=929";
var strCookie = document.cookie;
這會得到以分號分隔的所有名/值對字串。麻煩的是只能一次取得全部,無法按名稱取值,必須自己解析:
<script type="text/javascript">
document.cookie = "userId=828";
document.cookie = "userName=hulk";
var strCookie = document.cookie;
var arrCookie = strCookie.split("; "); // 切成多個名/值對
var userId;
for (var i = 0; i < arrCookie.length; i++) {
var arr = arrCookie[i].split("=");
if ("userId" == arr[0]) {
userId = arr[1];
break;
}
}
alert(userId);
</script>
核心技巧仍是字串與陣列操作。實務上建議把這段邏輯包成 getCookie(name) 函式重用。
截至目前為止的 Cookie 都是工作階段 Cookie:只存在記憶體中,瀏覽器關閉就消失。若要長期保存,加上 expires:
document.cookie = "userId=828; expires=" + GMT_String;
其中 GMT_String 是以 GMT 格式表示的時間字串。例如設定 10 天後過期:
<script type="text/javascript"> var date = new Date(); var expiresDays = 10; date.setTime(date.getTime() + expiresDays * 24 * 3600 * 1000); document.cookie = "userId=828; userName=hulk; expires=" + date.toGMTString(); </script>
把過期時間設為過去即可:
<script type="text/javascript"> var date = new Date(); date.setTime(date.getTime() - 10000); document.cookie = "userId=828; expires=" + date.toGMTString(); </script>
預設情況下,某頁面建立的 Cookie,同目錄的其他頁面與其子目錄都能存取。例如在 www.example.com/html/a.html 建立的 Cookie,可被 html/b.html 或 html/some/c.html 讀取,但 www.example.com/d.html 讀不到。
要明確控制範圍,使用 path 參數:
document.cookie = "name=value; path=cookieDir";
例如:
document.cookie = "userId=320; path=/shop"; // 僅 shop 目錄可用 document.cookie = "userId=320; path=/"; // 全站可用
與路徑類似,主機名指的是同一網域下的不同子站台,例如 www.example.com 與 mail.example.com。預設情況下彼此無法互讀,但可以透過 domain 參數放寬:
document.cookie = "name=value; domain=.example.com";
這樣所有 example.com 下的主機都能存取該 Cookie。
Cookie 的處理流程固定且繁瑣,適合抽成函式重用。
1. 新增:addCookie(name, value, expiresHours)
<script type="text/javascript">
function addCookie(name, value, expiresHours) {
var cookieString = name + "=" + escape(value);
// expiresHours 為 0 時不設過期時間,關閉瀏覽器即失效
if (expiresHours > 0) {
var date = new Date();
date.setTime(date.getTime() + expiresHours * 3600 * 1000);
cookieString = cookieString + "; expires=" + date.toGMTString();
}
document.cookie = cookieString;
}
</script>
2. 讀取:getCookie(name)
<script type="text/javascript">
function getCookie(name) {
var strCookie = document.cookie;
var arrCookie = strCookie.split("; ");
for (var i = 0; i < arrCookie.length; i++) {
var arr = arrCookie[i].split("=");
if (arr[0] == name) return unescape(arr[1]);
}
return "";
}
</script>
3. 刪除:deleteCookie(name)
<script type="text/javascript">
function deleteCookie(name) {
var date = new Date();
date.setTime(date.getTime() - 10000);
document.cookie = name + "=v; expires=" + date.toGMTString();
}
</script>
Cookie 仍是 HTTP 協定的一部分,登入工作階段(Session ID)依然靠它傳遞。但若要存放較大量的前端資料,localStorage 與 sessionStorage 更方便:容量約 5MB、API 是同步且直覺的鍵值操作、不會自動隨每次請求送出。若資料涉及敏感資訊,無論用哪一種,都應先加密並加上 HttpOnly、Secure、SameSite 等旗標保護。