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 des IDBFactory-Interfaces fordert die Löschung einer Datenbank an. Die Methode gibt sofort ein IDBOpenDBRequest-Objekt zurück und führt die Löschoperation asynchron aus.
Wenn die Datenbank erfolgreich gelöscht wird, wird ein success-Ereignis auf dem Rückgabeobjekt dieser Methode ausgelöst, wobei das result auf undefined gesetzt ist. Tritt ein Fehler während der Löschung der Datenbank auf, wird ein error-Ereignis auf dem Rückgabeobjekt dieser Methode ausgelöst.
Wenn deleteDatabase() aufgerufen wird, erhalten alle anderen offenen Verbindungen zu dieser speziellen Datenbank ein versionchange-Ereignis.
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 existierende 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 einbeziehen, der angibt, ob Sie eine
permanent(der Standardwert) IndexedDB oder eine IndexedDB imtemporarySpeicher (auch shared pool genannt) 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, hat die result-Eigenschaft der Anfrage den Wert 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 - Transaktionen verwenden:
IDBTransaction - Festlegen eines Schlüsselbereichs:
IDBKeyRange - Abrufen und Ändern Ihrer Daten:
IDBObjectStore - Verwendung von Cursoren:
IDBCursor - Referenzbeispiel: To-do Notifications (Beispiel live ansehen).