前端開發時常有把資料留在使用者瀏覽器裡的需求,例如記住上次的登入狀態、辨識第二次拜訪、暫存草稿。瀏覽器提供了幾種手段,但各自的性格差很多,選錯了會很痛苦。
cookie 最大的優勢是「自動」。使用者每發一次請求,cookie 就會跟著送到伺服器,PHP 這類後端語言能直接讀取處理,非常方便。缺點也一樣明顯:瀏覽器對 cookie 的數量與大小都有限制,而且 JavaScript 操作 cookie 的 API 極為原始,只有一個 document.cookie 字串,設定與讀取都得自己解析。相較之下,PHP 有 setcookie() 與 $_COOKIE,輕鬆太多。
以下是一組自己封裝的讀寫函式:
function setcookie(name, value, expired, path, domain){
var now = new Date();
if (name == null){
throw "Cookie Name Must not be Null";
} else if (value == null){
throw "Cookie Value Must not be Null";
} else if (expired == null){
expired = 0;
}
if (path == null){ path = "/"; }
if (domain == null){ domain = window.location.host; }
now.setTime(now.getTime() + expired * 1000);
document.cookie = name + "=" + escape(value)
+ ";expires=" + now.toGMTString()
+ ";path=" + path + ";domain=" + domain;
}
function getcookie(name){
var allcookie = document.cookie;
var thiscookie = allcookie.match(name + "=[^s]*");
var mycookie = thiscookie[0].split("=");
var a = mycookie[1].substring(0, mycookie[1].length - 1);
return unescape(a);
}
setcookie 前三個參數是必填,後兩個分別代表路徑與有效秒數。要刪除一個 cookie,把有效時間設成負值即可。getcookie 則是拿 name 去比對,回傳對應內容。
相較之下,localStorage 的 API 友善得多。它既能像普通物件一樣用點號或中括號取值,也提供了完整的方法:
// 寫入
localStorage.host = "www.example.com";
localStorage['host'] = "www.example.com";
localStorage.setItem("host", "www.example.com");
// 讀取
localStorage.host;
localStorage['host'];
localStorage.getItem("host");
// 刪除單筆 / 清空全部
localStorage.removeItem("host");
localStorage.clear();
但它有兩個天生的限制。第一,資料不會隨請求自動送往伺服器,若後端非要拿到,得自行轉寫成 cookie,或者用 ajax 主動送出。第二,localStorage 屬於 HTML5 的產物,舊版瀏覽器不支援;雖然今日這已不再是主要障礙,但在需要相容老舊環境的專案裡仍要留意。
需要伺服器參與、且資料量小的(例如 session 識別、使用者偏好),用 cookie。純粹是前端體驗、資料量較大的(草稿、快取、離線資料),用 localStorage。兩者並非互斥,實際專案裡常常並存。