使用 Indexed Database API 存取資料

HTML與SEO實戰應用—並以ChatGPT助力提升網站品質與流量

使用 Indexed Database API 開發的步驟為:

  • 建立資料庫
  • 建立 object store
  • 在 transaction 中處理資料

 

要開啟 Indexed DB 會使用 window.indexedDB.open("DB", 1),資料庫如果存在就會打開資料庫,如果不存在就會建立新的資料庫,並可以處理 success、error和 upgradeneeded 的事件。

function createDatabase() {
  var openDb = window.indexedDB.open("DB", 1);
  openDb.addEventListener('error', errorHandler);
  openDb.addEventListener('success', function (event) {
    console.log('success');
    db = event.target.result;
    console.log(db);
  })
  openDb.addEventListener('upgradeneeded', function (event) {
    console.log('upgradeneeded');
   })
}

發生錯誤時我們就直接把錯誤訊息顯示在 console 裡。

function errorHandler(event) {
	console.log(event.target.error.message)
}

其中 upgradeneeded 不是每次都會發生,只有在兩個情況下會觸發,一個是建立資料庫的時候,第二個則是版本改變的時候,版本為 open 事件後面傳入的第二個參數,版號只能是整數而且只能往上增加不能減少。這個事件是我們用來建立 object store 的時候會觸發。

 

Object Store是在資料庫中,用來存儲資料的地方,每筆資料是用key-value的格式來儲存,會在 upgradeneeded 事件中管理 object store,這裡我們把上面的程式碼改成在建立資料庫的時候同時建立 object store。

function createObjectStore() {
	var openDb = window.indexedDB.open("DB", 1);
	openDb.addEventListener('error', errorHandler);
	openDb.addEventListener('success', function (event) {
                db = event.target.result;
                console.log(db);
	 })
	//在 upgradeneeded 事件中管理 object store
            openDb.addEventListener('upgradeneeded', function (event) {
                db = event.target.result;
                if (db.objectStoreNames.contains("employees")) {
                    console.log("employees存在")
                } else {
                    var store = db.createObjectStore("employees", {
                        "keyPath": "employeeId",  //主索引鍵
                        "autoIncrement": true  
			})
			store.createIndex("nameIndex", "name", { unique: false }); //要有 index 才能搜尋
			store.createIndex("ageIndex", "age", { unique: false });
                }

	})
}

其中 createIndex 不一定要做,但如果想要該欄位可以搜尋的話就必須要做。

 

如果第一步有建立資料庫,這樣我們這邊就會無法在建立一樣名字的資料庫,所以這邊先寫一段刪除資料庫的程式。

//刪除資料庫
function deleteDatabase() {
	var delDb = window.indexedDB.deleteDatabase("DB");
		delDb.addEventListener('error', errorHandler);
		delDb.addEventListener('success', function (event) {
		console.log('資料庫刪除成功!!');
	})
}

要觀察資料庫是否建立以及內容,可以從開發者工具找到 IndexedDB 查看內容,這個在不同瀏覽器的位置會不大一樣可以依據瀏覽器尋找。

如果我們要刪除已建立的 object store,要使用 deleteObjectStore,需注意要更動 object store 就必須要變更版號才會觸發 upgradeneeded 進而刪除指定的 object store。

function deleteObjectStore() {
            var openDb = window.indexedDB.open(“DB”, 2); //需要變更版號才能觸發 upgradeneeded 刪除 object store
            openDb.addEventListener('error', errorHandler);
            openDb.addEventListener('success', function (event) {
                db = event.target.result;
                console.log(db);
            })
            //要在upgradeneeded事件中管理object store
            openDb.addEventListener('upgradeneeded', function (event) {
                db = event.target.result;
                db.deleteObjectStore("employees")
                console.log("objectstore刪除成功!!")

            })
}

 

接下來我們要將資料新增到 indexed db 裡,因為都需要透過 transaction 來修改資料,所以我們會先像這樣建立一個 transaction 物件,transaction 的模式包含 readonly、readwrite、versionchange,這邊因為我們要新增所以採用 readwrite。

var transaction = db.transaction(["employees"], "readwrite");
var store = trans.objectStore("employees");

接著我們再把資料寫入:

storeAdd=store.add({"name”:”Jason”,”age":30,"email”:”[email protected]"});
storeAdd.addEventListener("success",function(){
	console.log(“新增成功!!")
})
storeAdd.addEventListener("error",errorHandler);

 

要更新的話使用 put 並指定要修改的 primary key 就可以修改該筆資料:

store.put({employeeID:2, name: "Tom", email:
"[email protected]", "age": 32 });

刪除的話用 delete 指定要刪除的 primary key 就好了。

store.delete(1);

 

再來讀取 indexed db 裡的資料,首先我們還是要開啟 db,只是這邊就使用 readonly 就好了。

var trans = db.transaction(["employees"], "readonly");
var store = trans.objectStore("employees");

接著透過 openCursor() 取得 IDBCursor 物件

var cursorRequest = store.openCursor();

接著抓取 success 事件將資料讀出來:

cursorRequest.addEventListener("success",function(event){
	var result = event.target.result 
	//讀不到資料離開此function
	if(!result) return                    
	
	console.log(result.value);
	//讀下一筆資料
	result.continue();
})

 

以上是沒有篩選條件取出所有資料,若要加上篩選條件,則會使用 IDBKeyRange 物件,常用的方法有:

  • only("鍵值")
  • upperBound("最大值"[,boolean]), lowerBound("最小值"[,boolean])  //後面的 boolean 代表是否包含邊界值
  • bound ("最小值", "最大值"[, boolean[, boolean])

舉例來說,這樣就會透過 key path 搜尋資料

var cursorRequest = store.openCursor(IDBKeyRange.only(2));

預設是搜尋 key path 的值,若要切換的話則使用以下方法切換到別的欄位

var nameIdx = store.index("nameIndex");
var cursorRequest = nameIdx.openCursor(IDBKeyRange.only(‘Jason’));

要搜尋特定範圍的範例如下:

var cursorRequest = ageIdx.openCursor(IDBKeyRange.upperBound(30,true))

 

課程推薦

HTML與SEO實戰應用—並以ChatGPT助力提升網站品質與流量

HTML與SEO實戰應用—並以ChatGPT助力提升網站品質與流量

本課程專為希望深入了解 HTML 並有效結合 SEO 策略的學員設計。我們將重點放在 HTML 的深度學習與應用上,同時穿插介紹如何透過搜索引擎優化提升網站能見度。透過即時互動式的直播教學,加上 ChatGPT 的輔助,您將學習到如何建立一個結構優良、美觀且符合 SEO 標準的網站。這不僅會提升網站的用戶體驗,還會大幅提高網站的搜索引擎排名,進而增加訪客流量和潛在客戶。
用AI強化職場競爭力 ChatGPT、Midjourney從入門到精通

用AI強化職場競爭力 ChatGPT、Midjourney從入門到精通

在快速變遷的職場中,提升競爭力成為關鍵。透過引領潮流的AI技術,ChatGPT和Midjourney將助您勇攀高峰。無論您是AI新手還是專家,這個課程將引導您從入門到精通,解密AI的奧秘,並學習如何運用於職場。
GitHub Copilot AI 程式碼編輯工具應用實務班

GitHub Copilot AI 程式碼編輯工具應用實務班

讓學員瞭解有效地使用該工具來加速開發流程、提高程式碼品質和生產力。課程重點放在以 JavaScript 程式語言為例,介紹 Copilot 的基本原理、使用方法和最佳實踐。

輸入折扣碼 TC1456JA 還可以額外獲得 NT$500 優惠喔。

ChatGPT X Clipchamp AI 生成影片、配音與字幕應用實戰班

ChatGPT X Clipchamp AI 生成影片、配音與字幕應用實戰班

掌握Clipchamp AI的操作技巧,靈活運用Clipchamp AI進行影片編輯和創作,實現創意表達和傳播目的。

輸入折扣碼 TC1451JAN 還可以額外獲得 NT$500 優惠喔。

如何串接多種數位工具資訊?Looker Studio 資料視覺化實戰班|GoogleAds x FB廣告 x GA流量數據

如何串接多種數位工具資訊?Looker Studio 資料視覺化實戰班|GoogleAds x FB廣告 x GA流量數據

Looker Studio除了可協助使用者監控網站流量、廣告成效、選擇匯入資源的管道之外,還可以將數據資料多平台整合、數據報表即時更新、數據範本可重複套用的效益,透過自動化系統,將數據全部匯入同一個報表平台,是企業不可或缺的重要工具。

輸入折扣碼 TC1270JIA 還可以額外獲得 NT$500 優惠喔。

和我們交流

加入我們的社群,裡面會有一些技術的內容、有趣的技術梗,以及職缺的分享,歡迎和我們一起討論。