DIV CSS 佈局教程網

JavaScript Cookie 詳解:設定、讀取、過期、路徑與通用函式封裝
編輯:JavaScript綜合知識     

Cookie 是網站存放在使用者本機的一小段資料,它能讓伺服器辨識回访者、記住上次的停留時間與瀏覽過的頁面。它無法用來直接取得使用者的個人資訊,但足以支撐許多實用功能。本文完整梳理 JavaScript 操作 Cookie 的各個環節。

Cookie 的本質

如果說 JavaScript 變數是「頁面內的暫存資料」,Cookie 則是瀏覽器提供的一種機制:它把 document 物件的 cookie 屬性開放給 JavaScript 操作。也就是說,Cookie 並不是 JavaScript 本身的語法特性,而是宿主環境提供的ability。

Cookie 實際上是存於使用者硬碟的檔案,通常對應一個網域。當瀏覽器再次訪問同一網域時,該 Cookie 就會被帶上。因此 Cookie 可以跨越同一網域下的多個網頁,但無法跨網域使用。不同瀏覽器的實作細節有差異(例如 Windows 系統中檔案存放在使用者的 Cookies 目錄,命名格式類似 UserName@Domain.txt),但行為性質是一致的。

為什麼需要 Cookie

早期若想用一個固定不變的框架來存放購物車資料、搭配不斷變化的內容頁,看似能模擬全域變數,其實並不嚴謹——只要在框架頁面上按下滑鼠右鍵選擇「重新整理」,所有 JavaScript 變數都會消失。Cookie 因為寫在硬碟上,才能真正實現跨頁面的持久化狀態。

常見應用場景

  1. 保存登入狀態:把使用者 id 寫進 Cookie,下次造訪就不必重新登入。搭配過期時間,還能提供「保持登入一個月/三個月/一年」這類選項。
  2. 追蹤使用者行為:例如天氣網站記住上次選擇的地區,下次自動顯示當地天氣,一切在背景完成,頁面看起來就像為這位使用者量身訂做。
  3. 個人化頁面:換膚、版面配置、背景色、解析度等偏好都可以記錄下來,下次造訪仍維持上次的風格。
  4. 購物車:把瀏覽或選購過的商品記在 Cookie 中,結帳時統一送出,電商網站常用這招保留瀏覽紀錄以便隨時比較。

Cookie 的限制

  1. 使用者若重視隱私,可能直接在瀏覽器中停用 Cookie。
  2. Cookie 與瀏覽器綁定,同一頁面在不同瀏覽器之間無法共用。
  3. Cookie 是本機檔案,隨時可能被使用者刪除。
  4. 安全性偏低——所有內容都以純文字形式記錄,若要存放帳號密碼等敏感資訊,務必先加密。

設定 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

讀取 Cookie

讀取時直接取用 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>

刪除 Cookie

把過期時間設為過去即可:

<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 函式

Cookie 的處理流程繁瑣但高度相似,很適合抽成函式重用。

1. 新增 Cookie:addCookie(name, value, expiresHours)

約定 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>

2. 取得指定 Cookie:getCookie(name)

<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>

3. 刪除指定 Cookie:deleteCookie(name)

<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>

把這三個函式整理進共用的工具檔,之後任何頁面需要記住狀態時,只要呼叫一行即可,不必每次重寫解析邏輯。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved