Web Storage 是 HTML5 相當重要的一項功能,讓資料能存在客戶端。它概念上像 cookie,但能力強得多——cookie 被限制在 4KB,而 Web Storage 官方建議每個網站可用到 5MB。
sessionStorage:資料存在 session 中,瀏覽器(分頁)關閉即消失。
localStorage:資料長期保存在客戶端,除非手動刪除。
兩者的 API 完全相同,以下以 localStorage 為例:
localStorage.setItem(key, value); // 保存資料 localStorage.getItem(key); // 讀取資料 localStorage.removeItem(key); // 刪除單筆 localStorage.clear(); // 刪除全部 localStorage.key(index); // 取得某索引的 key localStorage.length; // 資料筆數
關鍵限制:key 與 value 都必須是字串。換句話說,Web Storage 的 API 只能操作字串,存物件時必須自行序列化——這點後面會示範解法。
我們要做一個簡單的通訊錄,功能有三項:
<!DOCTYPE HTML> <html> <head> <meta charset="utf-8"/> <title>HTML5 本地存儲之 Web Storage 篇</title> </head> <body> <div style="border:2px dashed #ccc; width:320px; text-align:center;"> <label for="user_name">姓名:</label> <input type="text" id="user_name" name="user_name" class="text"/> <br/> <label for="mobilephone">手機:</label> <input type="text" id="mobilephone" name="mobilephone"/> <br/> <input type="button" onclick="save()" value="新增記錄"/> <hr/> <label for="search_phone">輸入手機號:</label> <input type="text" id="search_phone" name="search_phone"/> <input type="button" onclick="find()" value="查找機主"/> <p id="find_result"></p> </div> <br/> <div id="list"></div> </body> </html>
畫面大致如下:

function save() {
var mobilephone = document.getElementById("mobilephone").value;
var user_name = document.getElementById("user_name").value;
localStorage.setItem(mobilephone, user_name);
} // 用於保存數據
實務上這裡應該先驗證手機號格式與必填欄位,並在 setItem 外圍包上 try/catch 以處理容量耗盡的情況。
// 查找數據
function find() {
var search_phone = document.getElementById("search_phone").value;
var name = localStorage.getItem(search_phone);
var find_result = document.getElementById("find_result");
find_result.innerHTML = search_phone + "的機主是:" + name;
}
若查無此號,getItem 會回傳 null,畫面上會顯示「null」這個字串。記得加一段判斷:
if (name === null) {
find_result.textContent = "查無此號碼";
return;
}

需要用到 localStorage.key(index) 搭配 length 遍歷:
// 將所有儲存在 localStorage 中的物件提取出來並呈現在界面上
function loadAll() {
var list = document.getElementById("list");
if (localStorage.length > 0) {
var result = "<table border='1'>";
result += "<tr><td>姓名</td><td>手機號碼</td></tr>";
for (var i = 0; i < localStorage.length; i++) {
var mobilephone = localStorage.key(i);
var name = localStorage.getItem(mobilephone);
result += "<tr><td>" + name + "</td><td>" + mobilephone + "</td></tr>";
}
result += "</table>";
list.innerHTML = result;
} else {
list.innerHTML = "目前數據為空,趕緊開始加入聯系人吧";
}
}

這段程式碼有 XSS 風險:使用者輸入的姓名會被直接拼進 innerHTML,若有人填入 <img src=x onerror=alert(1)> 就會被執行。正確做法是用 document.createElement 建立節點、以 textContent 填入文字,或至少先做 HTML 轉義。
上面的範例只有姓名與手機兩個欄位。若要加入公司名稱、家庭地址等,該怎麼辦?Web Storage 不是只能存字串嗎?
解法是用 JSON 序列化:存入前用 JSON.stringify() 把物件轉成字串,取出後用 JSON.parse() 還原成物件。
// 保存數據
function save() {
var contact = new Object();
contact.user_name = document.getElementById("user_name").value;
contact.mobilephone = document.getElementById("mobilephone").value;
contact.company = document.getElementById("company").value;
var str = JSON.stringify(contact);
localStorage.setItem(contact.mobilephone, str);
loadAll();
}
// 將所有儲存在 localStorage 中的物件提取出來並呈現在界面上
function loadAll() {
var list = document.getElementById("list");
if (localStorage.length > 0) {
var result = "<table border='1'>";
result += "<tr><td>姓名</td><td>手機</td><td>公司</td></tr>";
for (var i = 0; i < localStorage.length; i++) {
var mobilephone = localStorage.key(i);
var str = localStorage.getItem(mobilephone);
var contact = JSON.parse(str);
result += "<tr><td>" + contact.user_name
+ "</td><td>" + contact.mobilephone
+ "</td><td>" + contact.company + "</td></tr>";
}
result += "</table>";
list.innerHTML = result;
} else {
list.innerHTML = "目前數據為空,趕緊開始加入聯系人吧";
}
}

JSON.parse() 拋錯時(例如資料被使用者手動改壞)也要處理,建議包一層 try/catch,失敗就跳過該筆或清除它。
這個通訊錄要變完整,至少還需要:以手機號為 key 的修改與刪除功能(用 removeItem)、輸入時的即時驗證,以及一個「清空全部」的按鈕(localStorage.clear(),但要加確認對話框)。另外别忘了 localStorage 是同步 API,大量資料的讀寫會阻塞主執行緒,資料量大時該換成 IndexedDB。