上一篇介紹了 Web Storage(localStorage 與 sessionStorage),那是 key-value 形式的儲存。除了它之外,HTML5 早期還規劃過另一條路:直接在瀏覽器裡跑一個本機關聯式資料庫。做法是基於 SQLite——一種單檔型的輕量資料庫,做過 iOS/Android 開發的人應該對它不陌生。
先把重要前提講在前面:Web SQL Database 這套規格已被 W3C 於 2010 年停止維護,Chrome、Safari 之外的主要瀏覽器都沒有實作,Edge 與 Firefox 完全不支持。所以下面內容請當成歷史知識與維護舊專案時的參考;新專案要存結構化資料,應該直接用 IndexedDB。理解了 Web SQL 的寫法,再去看 IndexedDB 的物件導向 API 也會順手很多。
var db = openDatabase(databasename, version, description, size)
四個參數的作用:
databasename:資料庫名稱。version:版本號,可留空字串。description:資料庫描述。size:配置給這個資料庫的空間大小(位元組)。db.transaction(function (tx) {
// 在這裡執行資料庫操作
});
transaction 接受一個回呼函數,並把交易物件 tx 交給你,所有 SQL 都透過它執行。包在交易裡的好處是失敗時能整批回滾,不會留下半套資料。
tx.executeSql(sqlQuery, [value1, value2, ...], dataHandler, errorHandler)
四個參數:
sqlQuery:要執行的 SQL,可以是 create、select、update、delete。[value1, value2, ...]:SQL 中的參數值。寫法是在 SQL 裡用 ? 佔位,再把值依序放進這個陣列——這就是參數化查詢,能避免 SQL Injection,也省去自己處理引號跳脫。dataHandler:成功時的回呼,可從中取得結果集。errorHandler:失敗時的回呼。目標功能:新增聯絡人(姓名、手機、公司、建立時間)、列出所有聯絡人、刪除指定聯絡人。先準備頁面骨架:
<!DOCTYPE Html>
<Html>
<head>
<meta charset="utf-8"/>
<title>HTML5 本機儲存之本地資料庫篇</title>
<style>
.addDiv {
border: 2px dashed #ccc;
width: 400px;
text-align: center;
}
</style>
</head>
<body onload="loadAll()">
<div class="addDiv">
<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/>
<label for="company">公司:</label>
<input type="text" id="company" name="company"/>
<br/>
<input type="button" onclick="save()" value="新增記錄"/>
</div>
<br/>
<div id="list"></div>
</body>
</Html>
介面呈現:

// 開啟資料庫
var db = openDatabase('contactdb', '', 'local database demo', 204800);
// 儲存資料
function save() {
var user_name = document.getElementById("user_name").value;
var mobilephone = document.getElementById("mobilephone").value;
var company = document.getElementById("company").value;
// 建立時間
var time = new Date().getTime();
db.transaction(function (tx) {
tx.executeSql('insert into contact values(?,?,?,?)',
[user_name, mobilephone, company, time], onSuccess, onError);
});
}
// SQL 執行成功後的回呼
function onSuccess(tx, rs) {
alert("操作成功");
loadAll();
}
// SQL 執行失敗後的回呼
function onError(tx, error) {
alert("操作失敗,失敗資訊:" + error.message);
}
// 將所有存在 SQLite 資料庫中的聯絡人全部取出 function loadAll() { var list = document.getElementById("list"); db.transaction(function (tx) { // 若資料表不存在則建立 tx.executeSql('create table if not exists contact(name text, phone text, company text, createtime INTEGER)', []); // 查詢所有聯絡人記錄 tx.executeSql('select * from contact', [], function (tx, rs) { if (rs.rows.length > 0) { var result = "<table>"; result += "<tr><th>序號</th><th>姓名</th><th>手機</th><th>公司</th><th>新增時間</th><th>操作</th></tr>"; for (var i = 0; i < rs.rows.length; i++) { var row = rs.rows.item(i); // 轉換時間並格式化輸出 var time = new Date(); time.setTime(row.createtime); var timeStr = time.format("yyyy-MM-dd hh:mm:ss"); // 組裝一個表格列節點 result += "<tr><td>" + (i + 1) + "</td><td>" + row.name + "</td><td>" + row.phone + "</td><td>" + row.company + "</td><td>" + timeStr + "</td><td><input type='button' value='刪除' onclick='del(\"" + row.phone + "\")'/></td></tr>"; } list.innerHTML = result + "</table>"; } else { list.innerHTML = "目前資料為空,趕緊開始加入聯絡人吧"; } }); }); }取用結果集有兩種寫法:
rs.rows.item(i)與rs.rows[i]都可以拿到該列;rs.rows.length是列數,rs.rowsAffected則是 insert/update/delete 影響的筆數。時間格式化用的 format 方法
Date.prototype.format = function (format) { var o = { "M+" : this.getMonth() + 1, // month "d+" : this.getDate(), // day "h+" : this.getHours(), // hour "m+" : this.getMinutes(), // minute "s+" : this.getSeconds(), // second "q+" : Math.floor((this.getMonth() + 3) / 3), // quarter "S" : this.getMilliseconds() // millisecond } if (/(y+)/.test(format)) format = format.replace(RegExp.$1, (this.getFullYear() + "").substr(4 - RegExp.$1.length)); for (var k in o) if (new RegExp("(" + k + ")").test(format)) format = format.replace(RegExp.$1, RegExp.$1.length == 1 ? o[k] : ("00" + o[k]).substr(("" + o[k]).length)); return format; }刪除指定聯絡人
// 刪除聯絡人資訊 function del(phone) { db.transaction(function (tx) { // 注意這裡需明確地將傳入的參數轉為字串型別 tx.executeSql('delete from contact where phone=?', [String(phone)], onSuccess, onError); }); }表格樣式
th { font: bold 11px "Trebuchet MS", Verdana, Arial, Helvetica, sans-serif; color: #4f6b72; border-right: 1px solid #C1DAD7; border-bottom: 1px solid #C1DAD7; border-top: 1px solid #C1DAD7; letter-spacing: 2px; text-transform: uppercase; text-align: left; padding: 6px 6px 6px 12px; } td { border-right: 1px solid #C9DAD7; border-bottom: 1px solid #C9DAD7; background: #fff; padding: 6px 6px 6px 12px; color: #4f6b72; }最終的畫面:
幾個實務上的坑
示範程式把資料直接拼進 HTML 字串,真實專案請改用 DOM 節點建立並以
textContent填入,否則使用者輸入的內容可能變成 XSS 攻擊的入口。另外示範的刪除欄位刻意包了雙引號(del("0912345678")),因為手機號碼若當成數字傳遞,開頭的 0 與前導零都會出問題——這也是為什麼資料表裡手機號碼該用text而非整數型別。最後再強調一次:Web SQL 已停止演進, Safari 與舊版 Chrome 之外不宜依賴。要沿用這份架構的話,把
openDatabase/transaction/executeSql換成 IndexedDB 的indexedDB.open()與物件倉儲操作,功能與觀念都能一一對應。