Cookie 是網站存放在使用者本機的一小段資料,它能讓伺服器辨識回访者、記住上次的停留時間與瀏覽過的頁面。它無法用來直接取得使用者的個人資訊,但足以支撐許多實用功能。本文完整梳理 JavaScript 操作 Cookie 的各個環節。
如果說 JavaScript 變數是「頁面內的暫存資料」,Cookie 則是瀏覽器提供的一種機制:它把 document 物件的 cookie 屬性開放給 JavaScript 操作。也就是說,Cookie 並不是 JavaScript 本身的語法特性,而是宿主環境提供的ability。
Cookie 實際上是存於使用者硬碟的檔案,通常對應一個網域。當瀏覽器再次訪問同一網域時,該 Cookie 就會被帶上。因此 Cookie 可以跨越同一網域下的多個網頁,但無法跨網域使用。不同瀏覽器的實作細節有差異(例如 Windows 系統中檔案存放在使用者的 Cookies 目錄,命名格式類似 UserName@Domain.txt),但行為性質是一致的。
早期若想用一個固定不變的框架來存放購物車資料、搭配不斷變化的內容頁,看似能模擬全域變數,其實並不嚴謹——只要在框架頁面上按下滑鼠右鍵選擇「重新整理」,所有 JavaScript 變數都會消失。Cookie 因為寫在硬碟上,才能真正實現跨頁面的持久化狀態。
每個 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 看起來像一般屬性,但重新赋值並不會覆蓋舊值,而是「新增」一筆:
document.cookie = "userId=828";
document.cookie = "userName=hulk";
執行後瀏覽器會同時保留 userId 與 userName 兩個 Cookie,行為比較接近:
document.addCookie("userId=828");
document.addCookie("userName=hulk");
若要修改既有 Cookie,重新賦同名稱的值即可:
document.cookie = "userId=929"; // userId 被改成 929
讀取時直接取用 document.cookie:
var strCookie = document.cookie;
得到的是以分號串接的所有「名稱/值」對字串。麻煩之處在於:無法指定名稱取得單一值,必須自己解析字串。
<script language="JavaScript" 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>
核心技巧就是字串切割與陣列走訪。
截至目前為止的 Cookie 都屬於「工作階段 Cookie」,只存在記憶體中,瀏覽器關閉即消失。若要長期保存,需加上 expires:
document.cookie = "userId=828; expires=" + GMT_String;
GMT_String 是以 GMT 格式表示的時間字串。若要設定為十天後過期:
<script language="JavaScript" 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 language="JavaScript" type="text/javascript">
var date = new Date();
date.setTime(date.getTime() - 10000);
document.cookie = "userId=828; expires=" + date.toGMTString();
</script>
預設情況下,某頁面建立的 Cookie 會被同目錄與其子目錄的頁面共用。例如 /html/a.html 建立的 Cookie,/html/b.html 與 /html/some/c.html 都能讀到,但 /d.html 讀不到。用 path 參數可以控制:
document.cookie = "userId=320; path=/shop"; // 僅 shop 目錄可用
document.cookie = "userId=320; path=/"; // 全站可用
與路徑類似,domain 用來控制同一網域下的不同主機。預設情況下,www.google.com 建立的 Cookie 在 gmail.google.com 讀不到,但可以這樣放寬:
document.cookie = "name=value; domain=.google.com";
如此一來,google.com 底下的所有主機都能存取這個 Cookie。
Cookie 的處理流程繁瑣但高度相似,很適合抽成函式重用。
約定 expiresHours 為 0 時不設定過期時間,即關閉瀏覽器後自動消失。
<script language="JavaScript" type="text/javascript">
function addCookie(name, value, expiresHours) {
var cookieString = name + "=" + escape(value);
if (expiresHours > 0) {
var date = new Date();
date.setTime(date.getTime() + expiresHours * 3600 * 1000);
cookieString = cookieString + "; expires=" + date.toGMTString();
}
document.cookie = cookieString;
}
</script>
<script language="JavaScript" 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>
<script language="JavaScript" type="text/javascript">
function deleteCookie(name) {
var date = new Date();
date.setTime(date.getTime() - 10000);
document.cookie = name + "=v; expires=" + date.toGMTString();
}
</script>
把這三個函式整理進共用的工具檔,之後任何頁面需要記住狀態時,只要呼叫一行即可,不必每次重寫解析邏輯。