CKTIS / JavaScript
indexedDB.deleteDatabase — een volledige database verwijderen
indexedDB.deleteDatabase(name) verwijdert de opgegeven database asynchroon, inclusief de gegevens en structuur. De methode retourneert een request, geen Promise. Open verbindingen kunnen de bewerking blokkeren; de success-gebeurtenis bevestigt dat deze is voltooid.
Versie: 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) verwijdert de volledige opgegeven database binnen het huidige opslagbereik, met inbegrip van object stores, indexen en records. Het verwijdert niet slechts één record en sluit ook niet alleen een verbinding. De bewerking is destructief; gebruik uitsluitend de bedoelde naam.
De aanroep retourneert een IDBOpenDBRequest, geen Promise: await indexedDB.deleteDatabase(name) wacht niet op het verwijderen. Handel success, error en blocked af. Ook als de database niet bestaat, treedt succes op. Lees asynchrone fouten uit request.error; de aanroep zelf kan ook synchroon een SecurityError veroorzaken.
IndexedDB stuurt versionchange met newVersion === null naar open verbindingen die nog niet zijn gemarkeerd om te worden gesloten. Roep bij deze gebeurtenis doorgaans db.close() aan en gebruik de verbinding niet meer. Een verbinding die al is gemarkeerd om te worden gesloten, ontvangt deze gebeurtenis niet, maar kan het verwijderen nog blokkeren totdat de lopende transacties zijn afgerond. Als er nog een verbinding open is, geeft de aanvraag de gebeurtenis blocked af en wacht deze. Dat betekent niet dat de bewerking is geannuleerd of mislukt, of dat alle blokkerende verbindingen een melding hebben gekregen. Verbindingen in andere tabbladen tellen ook mee.
Dit is een Web-API, geen functie van een bepaalde ECMAScript-editie. Dat Node 24 in een repository aanwezig is, bewijst geen browserondersteuning. Voer het voorbeeld uit in een browser die IndexedDB beschikbaar stelt. Toegang tot de opslag is nodig om de database te kunnen verwijderen, maar niet om het voorbeeld uit te voeren. De code vangt geweigerde toegang af, zoals de uitvoer Deletion failed: SecurityError laat zien.
Voorbeelden
(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}`);
}
})();Resultaat
Deletion failed: SecurityError
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.