IDBDatabase: deleteObjectStore() 方法
注意:此功能在 Web Workers 中可用。
IDBDatabase 介面的 deleteObjectStore() 方法會銷燬連線資料庫中指定名稱的物件儲存以及引用它的所有索引。
與 IDBDatabase.createObjectStore 一樣,此方法只能在 versionchange 事務中呼叫。
語法
js
deleteObjectStore(name)
引數
name-
要刪除的物件儲存的名稱。名稱區分大小寫。
返回值
無(undefined)。
異常
InvalidStateErrorDOMException-
如果在
versionchange事務回撥之外呼叫該方法,則會丟擲此異常。 TransactionInactiveErrorDOMException-
如果對不存在的源資料庫(例如,已被刪除或移除)發出請求,則會丟擲此異常。
NotFoundErrorDOMException-
嘗試刪除不存在的物件儲存時丟擲。
示例
js
const dbName = "sampleDB";
const dbVersion = 2;
const request = indexedDB.open(dbName, dbVersion);
request.onupgradeneeded = (event) => {
const db = request.result;
if (event.oldVersion < 1) {
db.createObjectStore("store1");
}
if (event.oldVersion < 2) {
db.deleteObjectStore("store1");
db.createObjectStore("store2");
}
// etc. for version < 3, 4…
};
規範
| 規範 |
|---|
| Indexed Database API 3.0 # ref-for-dom-idbdatabase-deleteobjectstore① |
瀏覽器相容性
載入中…
另見
- 使用 IndexedDB
- 開始事務:
IDBDatabase - 使用事務:
IDBTransaction - 設定鍵的範圍:
IDBKeyRange - 檢索和修改資料:
IDBObjectStore - 使用遊標:
IDBCursor - 參考示例:待辦事項通知(檢視即時示例)。