DIV CSS 佈局教程網

JavaScript 設定、取得與刪除 Cookie 的三個通用函式
編輯:JavaScript綜合知識     

Cookie 的操作細節不少:名稱與值要編碼、過期時間要換算、路徑與網域要指定。把這些細節收進三個函式裡,之後任何頁面都能一行搞定。以下是一份可直接取用的實作。

設定 Cookie:setCookie

參數包含名稱、值、有效時間(以小時為單位)、路徑、網域與安全性旗標。

/*
 * 設置 Cookie
 * name:cookie 的鍵   value:值
 * expires:有效時間(小時)   path:可訪問路徑
 * domain:可訪問主機名       secure:是否僅透過 HTTPS 傳輸
 */
function setCookie(name, value, expires, path, domain, secure) {
  var str = name + "=" + escape(value);        // 名稱/值對,值需編碼

  if (expires > 0) {
    var date = new Date();
    date.setTime(date.getTime() + expires * 3600 * 1000);
    str += "; expires=" + date.toGMTString();
  }
  if (path)   str += "; path=" + path;
  if (domain) str += "; domain=" + domain;
  if (secure) str += "; secure";

  document.cookie = str;
}

取得 Cookie:getCookie

/*
 * 獲得 Cookie
 * cookie_name:cookie 的鍵
 */
function getCookie(cookie_name) {
  var value = null;
  var allcookies = document.cookie;
  var cookie_pos = allcookies.indexOf(cookie_name);

  if (cookie_pos != -1) {
    // 把位置移到值的起點
    cookie_pos += cookie_name.length + 1;
    var cookie_end = allcookies.indexOf(";", cookie_pos);
    if (cookie_end == -1) {
      cookie_end = allcookies.length;
    }
    value = unescape(allcookies.substring(cookie_pos, cookie_end));
  }
  return value;
}

刪除 Cookie:delCookie

Cookie 沒有真正的 delete 方法,作法是把它設為立即過期。

/*
 * 刪除 Cookie
 * cookie_name:cookie 的鍵
 */
function delCookie(cookie_name) {
  var exp = new Date();
  exp.setTime(exp.getTime() - 1);
  var value = getCookie(cookie_name);
  if (value) {
    document.cookie = cookie_name + "=" + value + ";expires=" + exp.toGMTString();
  }
}

使用方式

setCookie("userName", "hulk", 24, "/");   // 一天後過期,全站可用
var name = getCookie("userName");
delCookie("userName");

兩個容易忽略的細節

第一,getCookie 用 indexOf 尋找名稱時,可能誤命中前綴相同的 Cookie。例如要讀 user,卻先撞上 userName=xxx。較嚴謹的做法是先把 document.cookie 以 "; " 切成陣列,再用 split("=") 逐一比對完整名稱。

第二,escape() 與 unescape() 已被標準標示為避免使用,建議改用 encodeURIComponent() 與 decodeURIComponent(),後者對 UTF-8 中文的處理也更可靠。若要存放敏感資料,無論如何都不應直接寫入純文字的 Cookie。

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