HTML5 為瀏覽器端帶來了兩套全新的資料儲存機制:sessionStorage 與 localStorage。它們出現的初衷,正是為了填補傳統 Cookie 在結構化資料儲存上的先天缺口。
目前主流瀏覽器(包含 IE 系列)都已支援 HTML5 儲存,實務上我們會依「資料要活多久」分成兩類情境來選用。
sessionStorage 是為「單一工作階段」而設計的:同一個視窗內的多個頁面可以共用同一份資料,而不同視窗彼此互不干擾;一旦視窗關閉,資料隨之消失。
想像使用者在同一個網站開啟兩個視窗同時訂機票。若網站用 Cookie 記錄已選航班,其中一個視窗的選擇會「洩漏」到另一個視窗,使用者很可能在渾然不覺的情況下,重複購買了同一班機。HTML5 提供的 sessionStorage 正好解決這個問題:資料只在當前工作階段有效,開著視窗時可跨頁讀取,關掉視窗就自動作廢。
<!DOCTYPE html>
<html>
<body>
<script type="text/javascript">
if (sessionStorage.hits) {
sessionStorage.hits = Number(sessionStorage.hits) + 1;
} else {
sessionStorage.hits = 1;
}
document.write("總瀏覽次數:" + sessionStorage.hits);
</script>
<p>重新整理頁面,次數會持續累加。</p>
<p>關閉視窗後重新開啟,計數將從 1 重新開始。</p>
</body>
</html>
localStorage 的設計目標是「跨視窗、跨工作階段」長期保存。基於效能考量,Web 應用程式常需要把數百萬位元組的使用者資料放在用戶端,例如使用者撰寫中的整份文件、郵件草稿或大型設定檔。這類資料若交給 Cookie 處理會非常糟——因為每次請求都得重傳一遍。
透過 localStorage 屬性即可存取該頁面的本機儲存區域,而且沒有時間限制:只要使用同一個頁面,資料一直都在。
<!DOCTYPE html>
<html>
<body>
<script type="text/javascript">
if (localStorage.hits) {
localStorage.hits = Number(localStorage.hits) + 1;
} else {
localStorage.hits = 1;
}
document.write("總瀏覽次數:" + localStorage.hits);
</script>
<p>重新整理頁面,次數持續累加。</p>
<p>即使關閉視窗再開啟,結果依然保留。</p>
</body>
</html>
把敏感資料留在本機是有風險的,隨時可能成為安全隱患,因此清除機制必須清楚掌握:
localStorage.removeItem('key'),其中 key 即為要移除的鍵名。localStorage.clear()。<!DOCTYPE html>
<html>
<body>
<script type="text/javascript">
localStorage.clear(); // 一鍵清空所有本機資料
if (localStorage.hits) {
localStorage.hits = Number(localStorage.hits) + 1;
} else {
localStorage.hits = 1;
}
document.write("總瀏覽次數:" + localStorage.hits);
</script>
<p>由於每次載入都會先清空,重新整理不會讓計數增加。</p>
</body>
</html>
Web SQL Database API 並不屬於 HTML5 規格本體,而是一份獨立規格,它引入了一組以 SQL 操作用戶端資料庫的介面。值得一提的是,W3C 在 2010 年已停止該工作小組的維護,Web SQL 因此被標記為 deprecated;新建專案通常會改用 IndexedDB,小型資料則以 localStorage 因應。
var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024);
這個方法接受五個參數:資料庫名稱、版本號、說明文字、資料庫大小,以及最後的「建立回呼」。回呼會在資料庫建立完成後被觸發;即使不提供這個參數,執行期一樣會正確建立資料庫與版本。
查詢必須透過 database.transaction() 進行,該函數接受一個回呼參數,由它負責實際的查詢工作:
var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024);
db.transaction(function (tx) {
tx.executeSql('CREATE TABLE IF NOT EXISTS LOGS (id unique, log)');
});
上述語句會在 mydb 資料庫中建立一張名為 LOGS 的資料表。
var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024);
db.transaction(function (tx) {
tx.executeSql('CREATE TABLE IF NOT EXISTS LOGS (id unique, log)');
tx.executeSql('INSERT INTO LOGS (id, log) VALUES (1, "foobar")');
tx.executeSql('INSERT INTO LOGS (id, log) VALUES (2, "logmsg")');
});
若要寫入動態值,可改用參數placeholder,由 executeSql 依序對應到陣列中的每一個項目:
var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024);
db.transaction(function (tx) {
tx.executeSql('CREATE TABLE IF NOT EXISTS LOGS (id unique, log)');
tx.executeSql('INSERT INTO LOGS (id, log) VALUES (?, ?)', [e_id, e_log]);
});
這裡的 e_id 與 e_log 是外部變數,executeSql 會把參數陣列中的元素逐一對應到問號的位置。這種寫法同時能有效降低 SQL injection 的風險。
var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024);
db.transaction(function (tx) {
tx.executeSql('CREATE TABLE IF NOT EXISTS LOGS (id unique, log)');
tx.executeSql('INSERT INTO LOGS (id, log) VALUES (1, "foobar")');
tx.executeSql('INSERT INTO LOGS (id, log) VALUES (2, "logmsg")');
});
db.transaction(function (tx) {
tx.executeSql('SELECT * FROM LOGS', [], function (tx, results) {
var len = results.rows.length, i;
var msg = "<p>查詢到 " + len + " 筆資料</p>";
document.querySelector('#status').innerHTML += msg;
for (i = 0; i < len; i++) {
alert(results.rows.item(i).log);
}
}, null);
});
把插入與讀取合併到一份完整的 HTML5 文件中,就能直接在支援 Web SQL 的瀏覽器(例如當時的 Safari、Chrome)裡執行:
<!DOCTYPE html>
<html>
<head>
<script type="text/javascript">
var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024);
var msg;
db.transaction(function (tx) {
tx.executeSql('CREATE TABLE IF NOT EXISTS LOGS (id unique, log)');
tx.executeSql('INSERT INTO LOGS (id, log) VALUES (1, "foobar")');
tx.executeSql('INSERT INTO LOGS (id, log) VALUES (2, "logmsg")');
msg = '<p>日誌已建立,資料列已插入。</p>';
document.querySelector('#status').innerHTML = msg;
});
db.transaction(function (tx) {
tx.executeSql('SELECT * FROM LOGS', [], function (tx, results) {
var len = results.rows.length, i;
msg = "<p>查詢到 " + len + " 筆資料</p>";
document.querySelector('#status').innerHTML += msg;
for (i = 0; i < len; i++) {
msg = "<p><b>" + results.rows.item(i).log + "</b></p>";
document.querySelector('#status').innerHTML += msg;
}
}, null);
});
</script>
</head>
<body>
<div id="status" name="status">狀態訊息</div>
</body>
</html>
執行後頁面大致會呈現:
日誌已建立,資料列已插入。
查詢到 2 筆資料
foobar
logmsg
理解概念最快的方式,還是動手把上面幾段範例實際跑一次,觀察資料在重新整理與關閉視窗後的變化。