HTML5 中的 Web Storage 包含兩種儲存方式:sessionStorage 與 localStorage。sessionStorage 用於在本地儲存一個工作階段(session)中的數據,這些數據只有在同一個工作階段的頁面才能存取,並且當工作階段結束後,數據也會隨之銷毀。
因此 sessionStorage 並不是一種持久化的本地儲存,僅屬於工作階段層級的儲存。而 localStorage 則用於持久化的本地儲存,除非主動刪除,否則數據永遠不會過期。
Web Storage 的概念與 cookie 相似,差別在於它是為更大容量儲存而設計的。Cookie 的大小受限,而且每次請求新頁面時都會被發送過去,無形中浪費了帶寬;此外 cookie 還需指定作用域,無法跨域呼叫。除此之外,Web Storage 內建了 setItem、getItem、removeItem、clear 等方法,不像 cookie 需要前端開發者自行封裝 setCookie、getCookie。當然,Cookie 也有其不可替代之處:它的作用是與伺服器互動,作為 HTTP 規範的一部分而存在,而 Web Storage 僅是為了在本地「儲存」數據而生。
除了 IE7 及以下不支援外,其他標準瀏覽器都完全支援(IE 與 FF 需在 Web 伺服器中執行)。值得一提的是,IE7、IE6 中的 UserData 其實就是 JavaScript 本地儲存的解決方案,透過簡單的程式碼封裝,就能統一到所有瀏覽器都支援 Web Storage。要判斷瀏覽器是否支援 localStorage,可用下面的程式碼:
if(window.localStorage){ alert("浏覽支持localStorage") } else { alert("浏覽暫不支持localStorage") } //或者 if(typeof window.localStorage == 'undefined'){ alert("浏覽暫不支持localStorage") }localStorage 與 sessionStorage 具有相同的操作方法,例如 setItem、getItem 與 removeItem 等。
setItem 儲存 value,將 value 儲存到 key 欄位,用法:.setItem(key, value)
sessionStorage.setItem("key", "value"); localStorage.setItem("site", "js8.in");getItem 取得 value,獲取指定 key 本地儲存的值,用法:.getItem(key)
var value = sessionStorage.getItem("key"); var site = localStorage.getItem("site");removeItem 刪除 key,用法:.removeItem(key)
sessionStorage.removeItem("key"); localStorage.removeItem("site");clear 清除所有的 key/value,用法:.clear()
sessionStorage.clear(); localStorage.clear();
Web Storage 除了可用自身的 setItem、getItem 等方法存取,也可以像普通對象一樣用點(.)運算子及 [] 的方式進行數據儲存:
var storage = window.localStorage; storage.key1 = "hello"; storage["key2"] = "world"; console.log(storage.key1); console.log(storage["key2"]);
sessionStorage 與 localStorage 提供的 key() 和 length 可以方便地遍歷儲存的數據:
var storage = window.localStorage; for (var i=0, len = storage.length; i < len; i++) { var key = storage.key(i); var value = storage.getItem(key); console.log(key + "=" + value); }storage 還提供了 storage 事件,當鍵值改變或 clear 時就會觸發。下面的程式碼添加了一個 storage 事件變更的監聽:
if(window.addEventListener){ window.addEventListener("storage",handle_storage,false); } else if(window.attachEvent) { window.attachEvent("onstorage",handle_storage); } function handle_storage(e){ if(!e){e=window.event;} }storage 事件對象的具體屬性如下:
| Property | Type | Description |
|---|---|---|
| key | String | The named key that was added, removed, or modified |
| oldValue | Any | The previous value (now overwritten), or null if a new item was added |
| newValue | Any | The new value, or null if an item was removed |
| url/uri | String | The page that called the method that triggered this change |