View in English Always switch to English

IndexedDB API

備註: 此功能可在 Web Worker 中使用。

IndexedDB 是一種底層 API,用於在用戶端儲存大量結構化資料(包括檔案/Blob)。該 API 使用索引來實現對資料的高效能搜尋。雖然 Web Storage 對於儲存較少量的資料很有用,但對於儲存大量的結構化資料則較不適用。IndexedDB 提供了解決方案。這是 MDN IndexedDB 內容的主要登陸頁面——我們在此提供完整的 API 參考文件、使用指南、瀏覽器相容性細節,以及一些關鍵概念的說明。

關鍵概念與用法

IndexedDB 是一個交易式資料庫系統,就像 SQL 基礎的關聯式資料庫管理系統(RDBMS)。然而,不同於 SQL 基礎的 RDBMS 使用固定欄位的表格,IndexedDB 是一個 JavaScript 基礎的物件導向資料庫。IndexedDB 讓你儲存和檢索以鍵索引的物件;任何結構化複製演算法支援的物件都能被儲存。你需要指定資料庫綱要,開啟與資料庫的連線,然後在交易序列中檢索和更新資料。

閱讀更多關於 IndexedDB 關鍵特性和基本術語。
透過我們的使用 IndexedDB 指南,從基本原理開始學習非同步地使用 IndexedDB。
參見檢查截止日期是否已到指南中的完整逐步範例。

備註:就像大多數的 web 儲存解決方案,IndexedDB 遵循同源政策。因此雖然你可以存取同一個網域內的儲存資料,但你無法跨網域存取資料。

IDBFactory: 提供對資料庫的存取。此類型的物件是全域 Window.indexedDB 和 WorkerGlobalScope.indexedDB 屬性的值。因此它是 API 的進入點。
IDBOpenDBRequest: 代表開啟資料庫的請求。
IDBDatabase: 代表與資料庫的連線。這是獲取資料庫交易的唯一途徑。

檢索和修改資料

IDBTransaction: 代表一個交易。你在資料庫上建立一個交易,指定範圍(例如你想要存取哪個物件儲存區),並決定你想要的存取類型(唯讀或讀寫)。
IDBRequest: 處理資料庫請求並提供結果存取的通用介面。
IDBObjectStore: 代表一個物件儲存區,允許存取 IndexedDB 資料庫中的一組資料,透過主鍵尋找。
IDBIndex: 也允許存取 IndexedDB 資料庫中的資料子集,但使用索引來檢索紀錄而不是主鍵。這有時比使用 IDBObjectStore 更快。
IDBCursor: 迭代物件儲存區和索引。
IDBCursorWithValue: 迭代物件儲存區和索引並回傳游標目前的值。
IDBKeyRange: 定義一個鍵範圍,可用於從資料庫中檢索特定範圍內的資料。