Web SQL Database 規範已停止維護(主因:實現者高度同質化,幾乎皆採用 SQLite)。但理解其操作模式有助於掌握 HTML5 客戶端儲存演進脈絡。現代專案建議改用 IndexedDB 或封裝庫(如 localForage、Dexie.js、RxDB)。
// 資料庫操作核心類
const dataBaseOperator = {
// 開啟資料庫連線
openDatabase() {
return openDatabase(
'dataBaseUserStories', // 資料庫名稱
'1.0', // 版本
'User stories database', // 描述
2 * 1024 * 1024 // 大小 2MB
);
},
// 通用 SQL 執行方法(增刪改查皆適用)
execute(sql, params = []) {
return new Promise((resolve, reject) => {
const db = this.openDatabase();
db.transaction(tx => {
tx.executeSql(sql, params,
(_, result) => resolve(result),
(_, error) => { reject(error); return true; } // 返回 true 表示已處理錯誤
);
});
});
}
};
// 便利別名
dataBaseOperator.executeNonQuery = dataBaseOperator.execute;
dataBaseOperator.executeReader = dataBaseOperator.execute;
dataBaseOperator.executeScalar = dataBaseOperator.execute;
class UserStoryProvider {
constructor() {
this.tableName = 'tbUserStories';
}
// 建立資料表
async createTable() {
const sql = `CREATE TABLE IF NOT EXISTS ${this.tableName} (
id INTEGER PRIMARY KEY AUTOINCREMENT,
role TEXT, ability TEXT, benefit TEXT,
name TEXT, importance TEXT, estimate TEXT, notes TEXT
)`;
await dataBaseOperator.execute(sql);
}
// 刪除資料表
async dropTable() {
await dataBaseOperator.execute(`DROP TABLE IF EXISTS ${this.tableName}`);
}
// 新增故事
async add(story) {
const sql = `INSERT INTO ${this.tableName}
(role, ability, benefit, name, importance, estimate, notes)
VALUES (?, ?, ?, ?, ?, ?, ?)`;
const params = [
story.role, story.ability, story.benefit,
story.name, story.importance, story.estimate, story.notes
];
return dataBaseOperator.execute(sql, params);
}
// 刪除故事
async remove(id) {
return dataBaseOperator.execute(
`DELETE FROM ${this.tableName} WHERE id = ?`, [id]
);
}
// 讀取所有故事
async loadAll() {
const result = await dataBaseOperator.execute(
`SELECT * FROM ${this.tableName}`, []
);
return Array.from(result.rows).map(row => new UserStory(
row.id, row.name, row.role, row.ability,
row.benefit, row.importance, row.estimate, row.notes
));
}
}
// 領域模型
class UserStory {
constructor(id, name, role, ability, benefit, importance, estimate, notes) {
Object.assign(this, { id, name, role, ability, benefit, importance, estimate, notes });
}
}
// 初始化
const provider = new UserStoryProvider();
await provider.createTable();
// UI 綁定範例(配合 jQuery)
$('#btnAdd').on('click', async () => {
const item = {
role: $('#role').val(),
ability: $('#ability').val(),
benefit: $('#benefit').val(),
name: $('#name').val(),
importance: $('#importance').val(),
estimate: $('#estimate').val(),
notes: $('#notes').val()
};
try {
await provider.add(item);
await renderList();
} catch (e) { alert('新增失敗:' + e.message); }
});
async function renderList() {
const stories = await provider.loadAll();
$('#list').html(stories.map(s =>
`${s.name} (${s.role}) - ${s.estimate}pts `
).join(''));
}
// 頁面載入時渲染
$(document).ready(renderList);
Web SQL 採用非同步回調/Promise 模式,所有 DB 操作不阻塞 UI 執行緒。
使用 ? 佔位符 + 參數陣列,絕不直接字串拼接 SQL。
result.rows.length:筆數result.rows.item(i):取得第 i 筆物件result.insertId:自增主鍵值result.rowsAffected:影響列數// 開啟時指定版本,配合 changeVersion 進行結構遷移
const db = openDatabase('myDB', '2.0', 'desc', 5*1024*1024);
db.changeVersion('1.0', '2.0', tx => {
tx.executeSql('ALTER TABLE users ADD COLUMN email TEXT');
});
| 方案 | 優點 | 缺點 | 適用場景 |
|---|---|---|---|
| IndexedDB | 標準、大容量、索引查詢、事務支援 | API 複雜、學習曲線陡 | 大型離線應用、複雜查詢需求 |
| localStorage | API 簡單、同步、廣泛支援 | 5MB 限制、同步阻塞、僅字串 | 簡單鍵值對、設定檔、Token |
| localForage | 統一 API、自動降級、Promise 風格 | 需引入庫、間接層效能損耗 | 快速開發、跨瀏覽器相容 |
| Dexie.js | IndexedDB 友善封裝、TypeScript 支援 | 僅封裝 IndexedDB | 需 IndexedDB 功能但怕複雜 |
| RxDB | 即時同步、加密、Schema 驗證、Observable | 體積較大、學習成本高 | 協同應用、P2P 同步、複雜狀態 |