DIV CSS 佈局教程網

JavaScript Cookie 完整指南:設定、讀取與刪除
編輯:JavaScript綜合知識     

為什麼要在瀏覽器端保存資料

JavaScript 跑在瀏覽器這個用戶端環境裡,天生無法直接操作 Session——Session 是屬於伺服器端的資源。相對地,Cookie 存在於用戶端,正好可以由 JS 自由讀寫。

想像一個常見場景:使用者從 A 頁點進 B 頁。A 頁用某個變數暫存了一個值,到了 B 頁還想繼續沿用。這時你會發現,JavaScript 的全域變數也好、所謂的靜態變數也罷,生命週期都只限於當前頁面;一旦跳轉或關閉,它們就會被重新載入,等於什麼都沒留下。要讓資料跨頁存活,Cookie 是最直接的方案。

先認識 Cookie 的結構

Cookie 基本上就是一串鍵值對,形如 key=value,多筆資料之間以分號 ; 分隔。瀏覽器會把目前網域底下的所有 Cookie 都塞進 document.cookie 這個字串裡,所以讀取時需要自己切分出想要的項目。

寫入 Cookie

假設 A 頁要把變數 username(值為 jack)存進 Cookie,key 取 name:

document.cookie = "name=" + username;

讀取 Cookie

若 Cookie 內容是 name=jack;password=123,最直白的取法就是切字串:

var username = document.cookie.split(";")[0].split("=")[1];

這種寫法在只有一筆資料時堪用,但只要 Cookie 數量變多、順序改變就會出錯。實務上更建議用正則表達式精準比對:

function getCookie(name) {
  var arr, reg = new RegExp("(^| )" + name + "=([^;]*)(;|$)");
  if (arr = document.cookie.match(reg)) return unescape(arr[2]);
  else return null;
}

封裝成三個基本操作

把寫入、讀取、刪除整理成三個函式,之後到處都能直接呼叫。

設定(含過期時間)

function setCookie(name, value) {
  var Days = 30;
  var exp = new Date();
  exp.setTime(exp.getTime() + Days * 24 * 60 * 60 * 1000);
  document.cookie = name + "=" + escape(value) + ";expires=" + exp.toGMTString();
}

刪除

Cookie 沒有真正的 delete 方法,作法是把它設成「立刻過期」:

function delCookie(name) {
  var exp = new Date();
  exp.setTime(exp.getTime() - 1);
  var cval = getCookie(name);
  if (cval != null) document.cookie = name + "=" + cval + ";expires=" + exp.toGMTString();
}

使用範例

setCookie("name", "hayden");
alert(getCookie("name"));

自訂過期時間

如果希望過期時間可以傳入「秒/時/天」,只要把 setCookie 換成下面這組函式即可:

function setCookie(name, value, time) {
  var strsec = getsec(time);
  var exp = new Date();
  exp.setTime(exp.getTime() + strsec * 1);
  document.cookie = name + "=" + escape(value) + ";expires=" + exp.toGMTString();
}

function getsec(str) {
  var str1 = str.substring(1, str.length) * 1;
  var str2 = str.substring(0, 1);
  if (str2 == "s") return str1 * 1000;
  else if (str2 == "h") return str1 * 60 * 60 * 1000;
  else if (str2 == "d") return str1 * 24 * 60 * 60 * 1000;
}

呼叫方式很直覺:s20 代表 20 秒、h12 代表 12 小時、d30 代表 30 天。

setCookie("name", "hayden", "s20");

幾個實務提醒

  • 若不指定 expires,Cookie 只會在瀏覽器關閉後消失,也就是所謂的「工作階段 Cookie」。
  • Cookie 有大小上限(一般單筆 4KB 左右)與數量上限,且會隨每次請求送到伺服器,不適合存放大量資料。
  • 正式環境建議加上 path、domain,需要傳輸敏感資訊時務必加上 Secure 與 HttpOnly。
  • 現代專案若只是為了在前端保存狀態,localStorage 與 sessionStorage 往往比 Cookie 更合適。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved