IDBFactory: deleteDatabase()-Methode
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die deleteDatabase()-Methode der IDBFactory-Schnittstelle fordert die Löschung einer Datenbank an. Die Methode gibt sofort ein IDBOpenDBRequest-Objekt zurück und führt die Löschoperation asynchron durch.
Wenn die Datenbank erfolgreich gelöscht wird, wird ein success-Event auf dem von dieser Methode zurückgegebenen Anforderungsobjekt ausgelöst, wobei das result auf undefined gesetzt ist. Tritt ein Fehler bei der Löschung der Datenbank auf, so wird ein error-Event auf dem von dieser Methode zurückgegebenen Anforderungsobjekt ausgelöst.
Wenn deleteDatabase() aufgerufen wird, erhalten alle anderen offenen Verbindungen zu dieser spezifischen Datenbank ein versionchange-Event.
Syntax
// For the current standard:
deleteDatabase(name)
// For the experimental version with `options` (see below):
deleteDatabase(name)
deleteDatabase(name, options)
Parameter
name-
Der Name der Datenbank, die Sie löschen möchten. Beachten Sie, dass der Versuch, eine nicht vorhandene Datenbank zu löschen, keine Ausnahme auslöst, im Gegensatz zu
IDBDatabase.deleteObjectStore(), das eine Ausnahme auslöst, wenn der benannte Objekt-Store nicht existiert. optionsOptional Nicht standardisiert-
In Gecko, seit Version 26, können Sie einen nicht standardmäßigen optionalen Speicherparameter einschließen, der angibt, ob Sie eine
permanent(der Standardwert) IndexedDB oder eine IndexedDB imtemporary-Speicher (auch bekannt als Shared Pool) löschen möchten.
Rückgabewert
Ein IDBOpenDBRequest, bei dem nachfolgende Ereignisse im Zusammenhang mit dieser Anfrage ausgelöst werden.
Wenn die Operation erfolgreich ist, ist der Wert der result-Eigenschaft der Anfrage null.
Beispiele
const DBDeleteRequest = window.indexedDB.deleteDatabase("toDoList");
DBDeleteRequest.onerror = (event) => {
console.error("Error deleting database.");
};
DBDeleteRequest.onsuccess = (event) => {
console.log("Database deleted successfully");
console.log(event.result); // should be undefined
};
Spezifikationen
| Specification |
|---|
| Indexed Database API 3.0 # ref-for-dom-idbfactory-deletedatabase① |
Browser-Kompatibilität
Loading…
Siehe auch
- Verwendung von IndexedDB
- Transaktionen starten:
IDBDatabase - Verwendung von Transaktionen:
IDBTransaction - Festlegung eines Schlüsselspektrums:
IDBKeyRange - Abrufen und Ändern Ihrer Daten:
IDBObjectStore - Verwendung von Cursorn:
IDBCursor - Referenzbeispiel: To-do Notifications (Beispiel live ansehen).