Web Storage 是 HTML5 帶來的一組瀏覽器端儲存能力,專門用來在本機保存「鍵/值」形式的資料。它的定位與早期的 Cookie 相似,但更好用:容量大得多,而且不必再手寫 setCookie、getCookie 這類字串拼接函式。
Web Storage 分成兩型:localStorage 與 sessionStorage。兩者的底層機制幾乎相同,差別只在資料的「可見範圍」與「生命週期」。
透過 localStorage 物件就能取得一個 Storage 實例。Storage 負責存放字串對字串的對應關係,常用的屬性與方法如下:
clear():清除所有已存的鍵值對。getItem(key):以 key 取出對應的 value。key(index):以索引取出該位置的 key。length:回傳目前鍵值對的數量。removeItem(key):刪除指定的那一筆資料。setItem(key, value):新增一筆資料;若 key 已存在,效果等同更新。storage[key]:也可以用陣列下標的語法取值。也就是說,key 是唯一的。重複用同一個 key 呼叫 setItem,只會覆蓋舊值,不會產生第二筆。
下面這個範例做了一個小型的鍵值對管理介面:填入 Key 與 Value 後按 Add 存入,按 Clear 清空,右側表格即時反映目前的內容。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Example</title>
</head>
<body>
<div>
<div><label>Key:</label><input id="key" placeholder="Enter Key"></div>
<div><label>Value:</label><input id="value" placeholder="Enter Value"></div>
<div id="buttons">
<button id="add">Add</button>
<button id="clear">Clear</button>
</div>
<p id="countmsg">There are <span id="countLabel"></span> items</p>
</div>
<table id="data" border="1">
<tr><th>Item Count:</th><td id="count">-</td></tr>
</table>
<script>
displayData();
var buttons = document.getElementsByTagName('button');
for (var i = 0; i < buttons.length; i++) {
buttons[i].onclick = handleButtonPress;
}
function handleButtonPress(e) {
switch (e.target.id) {
case 'add':
var key = document.getElementById('key').value;
var value = document.getElementById('value').value;
localStorage.setItem(key, value);
break;
case 'clear':
localStorage.clear();
break;
}
displayData();
}
function displayData() {
var table = document.getElementById('data');
table.innerHTML = '';
var itemCount = localStorage.length;
document.getElementById('count').innerHTML = itemCount;
document.getElementById('countLabel').innerHTML = itemCount;
for (var i = 0; i < itemCount; i++) {
var key = localStorage.key(i);
var val = localStorage.getItem(key);
table.innerHTML += '<tr><th>' + key + ':</th><td>' + val + '</td></tr>';
}
}
</script>
</body>
</html>
執行結果如下:

要留意的是,瀏覽器不會主動清掉 localStorage 裡的資料。除非使用者自己刪除網站資料,或你以程式呼叫 clear(),否則它就會一直留在本機。
localStorage 的內容對「同源」的所有文件都是可見的。舉例來說,用同一個 Chrome 開啟兩個分頁拜訪同一個網址,其中一頁建立的資料,另一頁也讀得到;但若換成另一個瀏覽器(例如 Firefox)開啟同樣的網址,就看不到,因為那是另一個獨立的儲存空間。
如果希望在資料變動時收到通知,可以監聽 storage 事件。事件物件提供這些資訊:
key:發生變動的 key。oldValue:變動前的 value。newValue:變動後的 value。url:觸發這次變動的頁面網址。storageArea:發生變動的 Storage 物件,可藉此判斷是 localStorage 還是 sessionStorage。<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Storage</title>
<style>
table { border-collapse: collapse; }
th, td { padding: 4px; }
</style>
</head>
<body>
<table id="data" border="1">
<tr>
<th>key</th><th>oldValue</th><th>newValue</th>
<th>url</th><th>storageArea</th>
</tr>
</table>
<script>
var table = document.getElementById('data');
window.onstorage = function (e) {
var row = '<tr>';
row += '<td>' + e.key + '</td>';
row += '<td>' + e.oldValue + '</td>';
row += '<td>' + e.newValue + '</td>';
row += '<td>' + e.url + '</td>';
row += '<td>' + (e.storageArea === localStorage) + '</td>';
row += '</tr>';
table.innerHTML += row;
};
</script>
</body>
</html>
把範例一開在一個分頁、範例二開在另一個分頁,當你在範例一裡新增、修改或刪除資料,範例二的表格就會多出一列紀錄。(實測在 Chrome 運作正常,Firefox 當時沒有反應,其他瀏覽器未測試。)另外要記得:改動資料的那一頁本身不會收到事件,只有「別人」會收到。
執行結果:

sessionStorage 的 API 與 localStorage 一模一樣,差別只在可見範圍:它只在當前的工作階段內有效,頁面關閉後資料就消失。
<script>
displayData();
var buttons = document.getElementsByTagName('button');
for (var i = 0; i < buttons.length; i++) {
buttons[i].onclick = handleButtonPress;
}
function handleButtonPress(e) {
switch (e.target.id) {
case 'add':
var key = document.getElementById('key').value;
var value = document.getElementById('value').value;
sessionStorage.setItem(key, value);
break;
case 'clear':
sessionStorage.clear();
break;
}
displayData();
}
function displayData() {
var table = document.getElementById('data');
table.innerHTML = '';
var itemCount = sessionStorage.length;
document.getElementById('count').innerHTML = itemCount;
for (var i = 0; i < itemCount; i++) {
var key = sessionStorage.key(i);
var val = sessionStorage.getItem(key);
table.innerHTML += '<tr><th>' + key + ':</th><td>' + val + '</td></tr>';
}
}
</script>
執行效果:

由於 sessionStorage 有自己獨立的儲存空間,你在這個頁面上做任何修改,另一頁的 localStorage 內容完全不會受影響。
sessionStorage 用於保存單一工作階段的資料,只有同一 session 內的頁面能存取,session 一結束資料就跟著銷毀,因此它不是持久化儲存,只是工作階段層級的儲存。
localStorage 則是持久化的本地儲存,除非主動刪除,資料不會過期。
Web Storage 與 Cookie 的差異可以整理成幾點:
setItem、getItem、removeItem、clear,不必自己封裝。但 Cookie 依然不可或缺——它的存在本身就是 HTTP 規範的一部分,天生用來與伺服器互動;而 Web Storage 只為「在本地存資料」而生。兩者定位不同,該用哪一個取決於資料需不需要跟伺服器來回。