IndexedDB 是 HTML5 提供的一種瀏覽器端資料庫機制,允許網頁在用戶的瀏覽器中儲存大量結構化資料。與傳統只能存放字串的 localStorage 不同,IndexedDB 更接近物件導向的資料儲存方式,可以保存鍵值對、物件、陣列,甚至 Blob 等資料型別。
對於需要離線操作、資料暫存、表單草稿、客戶端快取或複雜查詢的 Web 應用來說,IndexedDB 提供了比 localStorage 更完整的解決方案。它的操作方式是異步的,並以交易作為資料一致性的重要基礎。
在過去,不同瀏覽器對 IndexedDB 的實作名稱可能帶有前綴,例如 webkitIndexedDB 或 mozIndexedDB。雖然現代瀏覽器多已支援標準名稱,但在撰寫相容性程式碼時,仍可以保留基本的判斷寫法。
var indexedDB = window.indexedDB || window.webkitIndexedDB || window.msIndexedDB;
if (!indexedDB) {
console.log("此瀏覽器不支援 IndexedDB。");
}
使用 IndexedDB 時,第一步通常是透過 open 方法開啟資料庫。open 方法一般接受兩個參數:資料庫名稱與版本號。如果資料庫不存在,瀏覽器會建立新的資料庫;如果版本號高於現有版本,則會觸發 onupgradeneeded 事件,讓開發者進行結構變更。
var request = indexedDB.open("databaseName", 1);
request.onerror = function (event) {
console.log("開啟資料庫失敗", event);
};
request.onsuccess = function (event) {
db = event.target.result;
console.log("資料庫開啟成功");
};
request.onupgradeneeded = function (event) {
var db = event.target.result;
var store = db.createObjectStore("users", { keyPath: "id" });
};
在這個例子中,我們建立了一個名為 users 的物件倉儲,也就是 object store。keyPath 設定為 id,代表每筆資料會以 id 作為唯一識別值。
IndexedDB 不使用傳統關聯式資料庫中的資料表,而是使用物件倉儲來保存資料。每一筆存入物件倉儲的資料都會有一個鍵值,開發者可以透過這個鍵快速取得資料,也可以建立索引來加速查詢。
例如,若希望日後能依姓名或電子郵件搜尋使用者,可以在物件倉儲建立完成後,針對指定欄位建立索引。索引並不會取代主鍵,而是提供另一種查詢路徑,讓資料讀取更有效率。
在 IndexedDB 中進行讀寫操作時,必須透過交易。交易可以確保一組操作要麼全部完成,要麼在發生錯誤時維持一致性。新增資料通常會建立一個 readwrite 交易,再呼叫 add 或 put 方法。
function addUser() {
var transaction = db.transaction(["users"], "readwrite");
var store = transaction.objectStore("users");
store.add({
id: "3",
name: "Gautam",
age: 30,
email: "gautam@example.com"
});
transaction.onsuccess = function () {
console.log("資料新增成功");
};
}
add 與 put 的差異在於,當相同鍵值已存在時,add 通常會失敗,而 put 則會覆寫既有資料。實際使用時可依需求選擇。
若要讀取單筆資料,可以使用 get 方法,並傳入對應的鍵值。由於物件倉儲已設定 id 作為 keyPath,因此 get 方法會依 id 找出符合的物件。
function getUser() {
var transaction = db.transaction(["users"]);
var store = transaction.objectStore("users");
var request = store.get("2");
request.onsuccess = function (event) {
var user = event.target.result;
if (user) {
console.log(user.name, user.age, user.email);
}
};
}
如果需要一次遍歷物件倉儲中的所有資料,可以使用 openCursor 建立游標。游標會逐筆走訪資料,開發者可以在每次成功事件中處理目前這筆資料,再呼叫 continue 前往下一筆。
function getAllUsers() {
var transaction = db.transaction(["users"]);
var store = transaction.objectStore("users");
var request = store.openCursor();
request.onsuccess = function (event) {
var cursor = event.target.result;
if (cursor) {
console.log(cursor.key, cursor.value.name);
cursor.continue();
}
};
}
刪除資料時,一樣需要建立 readwrite 交易,然後對物件倉儲呼叫 delete 方法,並傳入要刪除的鍵值。
function removeUser() {
var transaction = db.transaction(["users"], "readwrite");
var store = transaction.objectStore("users");
store.delete("1");
transaction.onsuccess = function () {
console.log("資料刪除成功");
};
}
localStorage 的操作通常是以單次設定或讀取為單位,並沒有內建的交易鎖定機制。若多個頁面同時讀寫同一份資料,可能會出現非預期的結果。IndexedDB 則以交易作為最小處理單位,透過交易機制降低這類競爭問題的風險。
以下概念性範例說明了兩個頁面同時操作 IndexedDB 時,可能會因為交易排隊而產生不同於 localStorage 的結果。由於 IndexedDB 會將需要處理的內容放入交易中,因此資料一致性通常比單純的 localStorage 更容易控制。
第一,IndexedDB 的操作是異步的,因此不能像同步變數那樣直接取得結果,必須透過事件或 Promise 風格的寫法處理。
第二,資料庫版本一旦提升,就必須在 onupgradeneeded 中處理結構變更,例如建立或刪除物件倉儲、建立索引等。
第三,不同瀏覽器對 IndexedDB 的支援程度與細節可能存在差異。在正式環境使用前,仍建議進行跨瀏覽器測試。
IndexedDB 讓前端應用具備更完整的資料儲存能力。透過物件倉儲、索引、交易與游標,開發者可以在瀏覽器中實作更複雜的資料操作。若應用需要儲存大量結構化資料,或需要在離線環境中維持較完整的互動體驗,IndexedDB 是非常值得掌握的 HTML5 技術。