Web Storage 是 HTML5 相當重要的一項功能,讓我們能在用戶端本地保存資料。它有點像 HTML4 時代的 Cookie,但能力強出許多:Cookie 的大小被限制在 4KB 左右,而 Web Storage 官方建議每個網站可用到 5MB。
Web Storage 又分為 sessionStorage 與 localStorage。從字面就能看出差別:sessionStorage 把資料存在 session 裡,瀏覽器關掉就沒了;localStorage 則會一直留在用戶端。
兩者的 API 完全相同,以下以 localStorage 為例:
localStorage.setItem(key, value)localStorage.getItem(key)localStorage.removeItem(key)localStorage.clear()localStorage.key(index)要注意的是,key 與 value 都必須是字串。換句話說,Web Storage 的 API 天生只能操作字串——這也埋下了後面 JSON 的伏筆。
接著我們用 Web Storage 做一個通訊錄小程式,需要實現三件事:
先準備一個簡單的 HTML 頁面:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>HTML5 本地儲存之 Web Storage 篇</title>
<script src="addressbook.js"></script>
</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"><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>
<div id="list"></div>
<script>loadAll();</script>
</body>
</html>
介面如下:

要實現聯絡人的保存,只要一個簡短的 JS 函式:
// 保存資料
function save() {
var mobilephone = document.getElementById('mobilephone').value;
var user_name = document.getElementById('user_name').value;
localStorage.setItem(mobilephone, user_name);
loadAll();
}
查找機主同樣容易:
// 查找資料
function find() {
var search_phone = document.getElementById('search_phone').value;
var name = localStorage.getItem(search_phone);
document.getElementById('find_result').innerHTML
= search_phone + ' 的機主是:' + name;
}

要把所有已存的聯絡人都列出來,就得靠 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 = "目前資料為空,趕緊開始加入聯絡人吧";
}
}
效果如下:

上面的範例只有姓名與手機兩個欄位。如果想存更豐富的聯絡人資訊,例如公司名稱、家庭地址,怎麼辦?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 = "目前資料為空,趕緊開始加入聯絡人吧";
}
}
效果如下:

第一,範例把使用者輸入的內容直接拼進 innerHTML,一旦有人存入含標籤的字串就會被當成 HTML 執行(也就是 XSS)。正式專案請改用 textContent 逐格填入,或先對內容做轉義。
第二,localStorage 只能存字串,數字、布林、陣列都會被轉成字串,取回來時記得自己轉型別;物件與陣列則一律走 JSON 這條路。