DIV CSS 佈局教程網

JavaScript 操作 cookie:設定、讀取與刪除
編輯:關於JavaScript     

Cookie 沒有物件化的 API,只能用 document.cookie 這個字串來操作:寫入是「指派」,讀取則要自己拆解。以下三個函數把常用的動作包好了。

// 設定 cookie
// name : 名稱
// value: 值
// time : 有效天數
function setCookie(name, value, time){
   var oDate = new Date();
   oDate.setDate(oDate.getDate() + time);
   document.cookie = name + "=" + value + ";expires=" + oDate.toUTCString();
}

// 讀取 cookie
function getCookie(name){
   var arr = document.cookie.split("; ");
   for (var i = 0; i < arr.length; i++) {
     var arr2 = arr[i].split("=");
     if (arr2[0] == name) {
       return arr2[1];
     }
   }
   return "";
}

// 刪除 cookie
// 手法是把有效期限設為現在(或過去),瀏覽器便會立即失效
function removeCookie(name){
   setCookie(name, "", -1);
}

幾個容易出錯的細節

· 寫入是「覆寫」而非新增。document.cookie = ... 每次只會新增或更新一個键值對,不會清掉其他 cookie。這行為與一般指派觀念不同,值得記住。

· 讀取要自己解析。document.cookie 回傳的是 "a=1; b=2; c=3" 這樣的單一字串,必須 split 之後逐一比對名稱。

· 值含分號或等號會出問題。原寫法用 split("=") 只取 arr2[1],若值裡本身有 =(例如 base64 編碼的內容)就會被截斷。比較穩健的寫法是用 indexOf('=') 切一次就好。

· 值必須編碼。中文、空白、分號等字元都要用 encodeURIComponent() 處理,讀回來再 decodeURIComponent()。

· 刪除不是真的刪。把過期時間設為過去,瀏覽器就會不再送出它,效果等同刪除。原寫法用 time = 0(今天到期)在很多瀏覽器上仍可讀到,改用 -1 較保險。

更完整的版本

function setCookie(name, value, days, options){
   options = options || {};
   var expires = options.expires;

   if (typeof days == 'number') {
     var date = new Date();
     date.setTime(date.getTime() + days * 24 * 60 * 60 * 1000);
     expires = options.expires = date;
   }

   if (expires && expires.toUTCString) {
     options.expires = expires.toUTCString();
   }

   value = encodeURIComponent(value);

   var updatedCookie = name + '=' + value;

   for (var key in options) {
     updatedCookie += '; ' + key;
     var val = options[key];
     if (val !== true) updatedCookie += '=' + val;
   }

   document.cookie = updatedCookie;
}

function getCookie(name){
   var matches = document.cookie.match(
     new RegExp('(?:^|; )' + name.replace(/([.$?*|{}()\[\]\\\/+^])/g, '\\$1') + '=([^;]*)')
   );
   return matches ? decodeURIComponent(matches[1]) : undefined;
}

function deleteCookie(name){
   setCookie(name, null, { expires: new Date(0) });
}

新版多了幾個實用參數:path(限制 cookie 作用路徑)、secure(只在 HTTPS 傳送)、samesite(避免跨站請求攜帶,可減輕 CSRF 風險)。

最後的選擇建議

如果不是必須相容舊版 IE,請優先使用 localStorage 或 sessionStorage:

localStorage.setItem('key', 'value');
localStorage.getItem('key');
localStorage.removeItem('key');

sessionStorage.setItem('key', 'value');   // 關閉分頁即失效

它們的 API 是真正物件化的、容量更大(通常 5MB 起,cookie 只有 4KB)、不會在每次請求時自動送到伺服器,因此也不會增加網路負擔。

反之,若資料需要被後端讀取(例如 session ID、使用者偏好同步),那就非得用 cookie 不可。另外要注意,不要把敏感資訊或未加密的驗證資料直接寫進 cookie,並記得加上 HttpOnly(由伺服器設定,讓 JavaScript 讀不到,可降低 XSS 偷取風險)與 Secure。

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