CKTIS / JavaScript
indexedDB.deleteDatabase — odstranění celé databáze
indexedDB.deleteDatabase(name) asynchronně odstraní pojmenovanou databázi včetně jejích dat a struktury. Vrací požadavek, nikoli Promise. Otevřená spojení mohou operaci zablokovat; její dokončení potvrzuje událost success.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const request = indexedDB.deleteDatabase(name);indexedDB.deleteDatabase(name) odstraní celou pojmenovanou databázi v aktuálním úložišti, včetně objektových úložišť, indexů a záznamů. Neodstraní pouze jeden záznam ani jen neuzavře spojení. Operace je destruktivní; používejte pouze zamýšlený název.
Volání vrací IDBOpenDBRequest, nikoli Promise: await indexedDB.deleteDatabase(name) na odstranění nečeká. Zpracujte události success, error a blocked. Úspěch nastane i tehdy, když databáze neexistuje. Asynchronní chyby čtěte z request.error; samotné volání může také synchronně vyvolat SecurityError.
IndexedDB odesílá událost versionchange s newVersion === null otevřeným spojením, která ještě nejsou označena jako čekající na uzavření. Při zpracování této události zpravidla zavolejte db.close() a přestaňte spojení používat. Spojení, které již čeká na uzavření, tuto událost nedostane, ale může odstranění dál blokovat, dokud neskončí jeho probíhající transakce. Pokud některé spojení zůstane otevřené, požadavek vyvolá blocked a čeká. Neznamená to, že bylo odstranění zrušeno nebo že selhalo, ani že všechna blokující spojení byla upozorněna. Počítají se i spojení v jiných kartách.
Jde o Web API, nikoli o funkci konkrétní edice ECMAScriptu. Přítomnost Node 24 v repozitáři nedokládá podporu v prohlížeči. Spusťte příklad v prohlížeči, který zpřístupňuje IndexedDB. Přístup k úložišti je nutný k úspěšnému odstranění databáze, ne však ke spuštění příkladu. Kód ošetřuje i odepření přístupu, jak ukazuje výstup Deletion failed: SecurityError.
Příklady
(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}`);
}
})();Výsledek
Deletion failed: SecurityError
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.