IDBDatabase: deleteObjectStore() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
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
InvalidStateErrorDOMException-
Wird ausgelöst, wenn die Methode nicht aus einem
versionchangeTransaktions-Callback aufgerufen wurde. TransactionInactiveErrorDOMException-
Wird ausgelöst, wenn eine Anfrage an eine Quell-Datenbank gestellt wird, die nicht existiert (z. B. gelöscht oder entfernt wurde).
NotFoundErrorDOMException-
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
| Spezifikation |
|---|
| Indexed Database API 3.0 # ref-for-dom-idbdatabase-deleteobjectstore① |
Browser-Kompatibilität
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).