DIV CSS 佈局教程網

JavaScript 操作 cookie:記住使用者的設定
編輯:關於JavaScript     

問題:希望使用者在訪問頁面時能沿用上次的設定,或在不同頁面之間共享資料。例如使用者調整了頁面字體大小,會希望下次進來時仍維持同樣的設定,而不必重複調整。

解法:在使用者瀏覽並設定時,把這些設定寫進 cookie;下次訪問時再讀出來套用。

工具函式:產生到期時間

// 產生格式正確的到期日期
function getExpDate(days, hours, minutes)
{
  var expDate = new Date();
  if (typeof(days) == "number" && typeof(hours) == "number"
      && typeof(minutes) == "number")
  {
    expDate.setDate(expDate.getDate()   + parseInt(days));
    expDate.setHours(expDate.getHours() + parseInt(hours));
    expDate.setMinutes(expDate.getMinutes() + parseInt(minutes));
    return expDate.toGMTString();
  }
}

注意條件判斷的地方:原式中第二個判斷重複檢查了 hours,導致 minutes 從未被驗證。這類「複製貼上後忘記改」的錯誤在型別檢查中特別容易漏掉,因為它不會報錯,只會安靜地讓某個參數不受檢查。

讀取 cookie 的值

// 由 getCookie() 呼叫,取出 offset 之後到下一個分號之間的內容
function getCookieVal(offset)
{
  var endstr = document.cookie.indexOf(";", offset);
  if (endstr == -1)
  {
    endstr = document.cookie.length;
  }
  return unescape(document.cookie.substring(offset, endstr));
}

// 依名稱取得 cookie 的主要函式
function getCookie(name)
{
  var arg  = name + "=";
  var alen = arg.length;
  var clen = document.cookie.length;
  var i = 0;
  while (i < clen)
  {
    var j = i + alen;
    if (document.cookie.substring(i, j) == arg)
    {
      return getCookieVal(j);
    }
    i = document.cookie.indexOf(" ", i) + 1;
  }
  return null;
}

寫入與刪除

function setCookie(name, value, expires, path, domain, secure)
{
  var argv = setCookie.arguments;
  var argc = setCookie.arguments.length;
  var expires = (argc > 2) ? argv[2] : null;
  var path    = (argc > 3) ? argv[3] : null;
  var domain  = (argc > 4) ? argv[4] : null;
  var secure  = (argc > 5) ? argv[5] : false;

  document.cookie = name + "=" + escape(value) +
    ((expires == null) ? "" : ("; expires=" + expires)) +
    ((path == null) ? "" : ("; path=" + path)) +
    ((domain == null) ? "" : ("; domain=" + domain)) +
    ((secure == true) ? "; secure" : "");
}

// 刪除:把到期時間設為過去
function deleteCookie(name, path)
{
  document.cookie = name + "=; expires=Thu, 01 Jan 1970 00:00:00 GMT" +
    ((path == null) ? "" : "; path=" + path);
}

使用時必須注意的四件事

path 一定要設。不設 path 的話,cookie 的預設範圍是當前路徑,從其他頁面會讀不到。這是最常見的「明明寫了卻讀不到」的原因。實務上通常設為 "/"。

不要用 escape/unescape。這兩個函式已被棄用,且對 UTF-8 的處理不正確(中文會被編碼成 %uXXXX 這種非標準格式)。請改用 encodeURIComponent 與 decodeURIComponent。

別把敏感資料放進 cookie。它會隨每次請求送到伺服器,使用者也能直接檢視與竄改。身分權杖請加上 Secure 與 HttpOnly(後者需由伺服器設定,JavaScript 無法設),並設定合理的 SameSite。

容量與數量都有限制。一般來說單一 cookie 約 4KB,同一網域總數也有上限。要存較大的資料,請用 localStorage(約 5~10MB,且不會隨請求送出)。

最後, cookie 有可能被使用者停用。任何依賴 cookie 的功能都應該有降級方案,例如把設定存進 URL 參數或讓使用者手動選擇,而不是讓頁面在讀不到 cookie 時直接出錯。

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