CKTIS / JavaScript
indexedDB.deleteDatabase — eine ganze Datenbank löschen
indexedDB.deleteDatabase(name) löscht die benannte Datenbank samt Daten und Struktur asynchron. Die Methode gibt eine Anfrage und kein Promise zurück. Offene Verbindungen können den Vorgang blockieren; das success-Ereignis bestätigt den Abschluss.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const request = indexedDB.deleteDatabase(name);indexedDB.deleteDatabase(name) löscht die gesamte benannte Datenbank im aktuellen Speicherbereich, einschließlich Objektspeichern, Indizes und Datensätzen. Es löscht nicht nur einen einzelnen Datensatz und schließt auch nicht bloß eine Verbindung. Der Vorgang ist destruktiv; verwende ausschließlich den beabsichtigten Namen.
Der Aufruf gibt ein IDBOpenDBRequest und kein Promise zurück: await indexedDB.deleteDatabase(name) wartet nicht auf das Löschen. Behandle success, error und blocked. Auch wenn die Datenbank nicht existiert, tritt Erfolg ein. Lies asynchrone Fehler über request.error aus; der Aufruf selbst kann außerdem synchron einen SecurityError auslösen.
IndexedDB sendet versionchange mit newVersion === null an offene Verbindungen, die noch nicht zum Schließen vorgemerkt sind. Rufe bei diesem Ereignis normalerweise db.close() auf und verwende die Verbindung nicht weiter. Eine bereits zum Schließen vorgemerkte Verbindung erhält dieses Ereignis nicht, kann das Löschen aber weiterhin blockieren, bis ihre laufenden Transaktionen abgeschlossen sind. Bleibt eine Verbindung offen, löst die Anfrage blocked aus und wartet. Das bedeutet weder Abbruch noch Fehlschlag und auch nicht, dass alle blockierenden Verbindungen benachrichtigt wurden. Verbindungen in anderen Tabs zählen ebenfalls.
Dies ist eine Web-API und keine Funktion einer bestimmten ECMAScript-Ausgabe. Dass sich Node 24 in einem Repository befindet, belegt keine Browserunterstützung. Führe das Beispiel in einem Browser aus, der IndexedDB bereitstellt. Der Zugriff auf den Speicher ist für das erfolgreiche Löschen nötig, nicht aber für die Ausführung des Beispiels. Der Code behandelt verweigerten Zugriff; genau diesen Fall zeigt die Ausgabe Deletion failed: SecurityError.
Beispiele
(async () => {
const name = `cktis-delete-${crypto.getRandomValues(new Uint32Array(4)).join('-')}`;
const result = request => new Promise((resolve, reject) => {
request.onsuccess = () => resolve(request.result);
request.onerror = () => reject(request.error);
});
try {
try {
const seed = indexedDB.open(name, 1);
seed.onupgradeneeded = () => {
seed.result.createObjectStore('items').put('fixture', 'key');
};
const db = await result(seed);
db.close();
} catch (error) {
if (error.name !== 'SecurityError') throw error;
// Still exercise deleteDatabase when fixture creation is denied.
}
const deletion = indexedDB.deleteDatabase(name);
deletion.onblocked = () => console.log('Deletion blocked by an open connection');
deletion.onerror = () => console.log(`Deletion failed: ${deletion.error.name}`);
deletion.onsuccess = event => {
console.log(`Deletion complete: old version ${event.oldVersion}, new version ${event.newVersion}`);
};
} catch (error) {
console.log(`Deletion failed: ${error.name}`);
}
})();Ergebnis
Deletion failed: SecurityError
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.