因為 IndexedDB 的原生寫法太過古老繁瑣且難以維護,因此實作中會使用 Promise版的IndexedDB。
一、什麼是「Promise 版」?為什麼要這樣做?
1. 原生 IndexedDB 的問題:傳統的事件監聽(Callback)
IndexedDB 是很久以前就有的語法,採用 「發起請求 → 監聽事件」 的方式運作。
如果直接用原生語法寫,光是打開資料庫、讀取一筆資料,程式碼會是過深的巢狀,資料庫邏輯很難獨立拆分出來,因此接下來會使用Promise版。
2. 什麼是「Promise 版」?
在現代 JavaScript 中,習慣使用 Promise 與 async / await,讓非同步的程式碼讀起來就像一般的同步程式碼一樣直覺:
1 | // Promise 版寫法 |
所謂「封裝成 Promise 版」,就是寫一個包裝函式(Helper),把原生繁瑣的事件監聽(onsuccess / onerror)包在 Promise 的 resolve() 與 reject() 裡面。
這樣一來,只要簡單用 await 就能輕鬆跟資料庫溝通。
二、設計 TaskTimerDB 資料庫結構
在開始寫程式之前,先規劃好瀏覽器資料庫裡的藍圖:
資料庫名稱(Database Name):
TaskTimerDB版本號(Version):
1資料表名稱(Object Store):
tasks主鍵(Key Path):
id(以每個主任務的id為唯一識別碼)
三、實作 db.js 封裝模組
為了保持程式碼結構清晰,另外建立一個獨立的 db.js 檔案,專門管理 IndexedDB 的連線與資料操作。
步驟 1:建立基礎設定與連線控制 (openDB)
首先設定資料庫名稱、版本與資料表(Object Store)名稱,並實作 openDB() 函式。這裡使用單例模式(Singleton)暫存連線,避免重複觸發開啟資料庫的操作。
1 | // ========================================== |
重點解析:
onupgradeneeded:只有在資料庫首次建立,或DB_VERSION升級時才會觸發,是建立 Object Store 的唯一時機。keyPath: "id":指定每筆任務物件中的id欄位作為唯一主鍵。
步驟 2:實作取得所有任務 (getAllTasksFromDB)
接著封裝讀取邏輯。因為 IndexedDB 是非同步操作,我們透過 await openDB() 拿到連線後,開啟唯讀交易(readonly)並回傳 Promise 物件。
1 | /** |
重點解析:
store.getAll():直接撈出tasks資料表內的所有資料。如果資料庫還沒有任何資料,則回傳空陣列[]作為預設值。
步驟 3:實作覆寫與儲存任務 (saveAllTasksToDB)
最後是同步最新資料到資料庫的函式。這裡採用「全量覆寫」策略:先清空整個 Object Store,再將畫面上最新狀態的任務陣列批次寫入。
1 | /** |
重點解析:
readwrite交易類型:執行寫入、更新與刪除時必須宣告為readwrite。transaction.oncomplete:IndexedDB 的交易會在所有寫入操作完成後觸發oncomplete,在這裡resolve(true)才能確保資料已真正寫入磁碟。
重點小結
使用簡潔的函式名稱:把所有底層複雜的交易(Transaction)與事件監聽通通藏在
db.js內部,對外只看得見簡潔的函式名稱。單例模式(Singleton):利用
dbInstance記錄連線狀態,不用每次存資料都重新開啟一次資料庫,執行效能更好。完美對接 TaskTimer 的全域 State:因為
TaskTimer採用單一tasks陣列驅動畫面,所以提供saveAllTasksToDB()可以安心地將整包 State 直接同步存進瀏覽器。
(參考資料:Mdn - Using IndexedDB)