IDBDatabase: deleteObjectStore() Methode
Hinweis: Dieses Feature ist verfügbar in Web Workers.
Die deleteObjectStore()
Methode des IDBDatabase
Schnittstelle zerstört den Objektspeicher mit dem angegebenen Namen in der verbundenen Datenbank, zusammen mit allen damit referenzierten Indizes.
Wie bei IDBDatabase.createObjectStore
kann diese Methode nur innerhalb einer versionchange
Transaktion aufgerufen werden.
Syntax
deleteObjectStore(name)
Parameter
name
-
Der Name des Objektspeichers, den Sie löschen möchten. Namen sind case-sensitiv.
Rückgabewert
Keiner (undefined
).
Ausnahmen
InvalidStateError
DOMException
-
Wird ausgelöst, wenn die Methode nicht aus einem
versionchange
Transaktions-Callback aufgerufen wurde. TransactionInactiveError
DOMException
-
Wird ausgelöst, wenn eine Anfrage an eine Quell-Datenbank gestellt wird, die nicht existiert (z. B. gelöscht oder entfernt wurde).
NotFoundError
DOMException
-
Wird ausgelöst, wenn versucht wird, einen nicht existierenden Objektspeicher zu löschen.
Beispiele
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…
};
Spezifikationen
Specification |
---|
Indexed Database API 3.0 # ref-for-dom-idbdatabase-deleteobjectstore① |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- Verwendung von IndexedDB
- Starten von Transaktionen:
IDBDatabase
- Verwendung von Transaktionen:
IDBTransaction
- Einstellung eines Schlüsselbereichs:
IDBKeyRange
- Abrufen und Ändern Ihrer Daten:
IDBObjectStore
- Verwendung von Cursoren:
IDBCursor
- Referenzbeispiel: To-do Notifications (Beispiel live ansehen).