在 document 物件中有一個 cookie 屬性。而 Cookie 本身,用 MSIE 說明文件的說法:「某些網站會在你的硬碟上存放很小的文字檔,用來保存一些資訊,這些檔案就稱為 Cookie。」
它們通常由 CGI 或更進階的程式產生,但 JavaScript 也提供了相當完整的存取能力。
每個 Cookie 的格式為 <cookie名>=<值>。命名限制與 JavaScript 變數類似,但少了「不可用關鍵字」這條,多了「只能使用可用於 URL 編碼的字元」——最簡單的應對方式就是只用字母與數字。<值> 也同樣受此限制。
幾個重要特性:
直接讀取這個屬性,就能知道目前文件有哪些 Cookie:
document.write(document.cookie);
輸出可能像這樣:
name=kevin; email=kevin@kevin.com; lastvisited=index.html
代表有三個 Cookie,成對以「分號加空格」分隔。因此可以這樣拆成陣列:
var cookieString = document.cookie;
var cookies = cookieString.split('; ');
與一般賦值不同,向 document.cookie 賦值不會清除既有的 Cookie,而是新增或覆寫同名者。格式如下:
document.cookie = 'cookieName=' + escape('cookieValue')
+ ';expires=' + expirationDateObj.toGMTString();
三個細節必須注意:
若不指定 expires,Cookie 會在瀏覽器完全關閉後過期。
var expires = new Date(); expires.setTime(expires.getTime() + 3 * 30 * 24 * 60 * 60 * 1000); /* 三個月 × 每月 30 天 × 每天 24 小時 × 每小時 60 分 × 每分 60 秒 × 每秒 1000 毫秒 */ document.cookie = 'name=rose;expires=' + expires.toGMTString();
這裡沒用 escape(),是因為我們確定 rose 本身就是合法的編碼字串,'rose' == escape('rose')。一般來說,寫入時不用 escape(),讀取時也就不用 unescape(),兩邊要成對。
提醒:Cookie 會隨每次請求送到伺服器,且容量只有數 KB,因此不適合存放大量資料。現代前端若只需在本機保存狀態,localStorage 與 sessionStorage 是更合適的選擇。