CKTIS / JavaScript
indexedDB.deleteDatabase — odstránenie celej databázy
indexedDB.deleteDatabase(name) asynchrónne odstráni pomenovanú databázu vrátane jej údajov a štruktúry. Vráti požiadavku, nie Promise. Otvorené spojenia môžu operáciu zablokovať; jej dokončenie potvrdzuje udalosť success.
Verzia: 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) odstráni celú pomenovanú databázu v aktuálnom úložisku vrátane objektových úložísk, indexov a záznamov. Neodstraňuje iba jeden záznam ani len nezatvára spojenie. Operácia je deštruktívna; používajte iba zamýšľaný názov.
Volanie vráti IDBOpenDBRequest, nie Promise: await indexedDB.deleteDatabase(name) na odstránenie nečaká. Ošetrite udalosti success, error a blocked. Úspech nastane aj vtedy, keď databáza neexistuje. Asynchrónne chyby čítajte z request.error; samotné volanie môže tiež synchrónne vyvolať SecurityError.
IndexedDB odosiela udalosť versionchange s newVersion === null otvoreným spojeniam, ktoré ešte nie sú označené ako čakajúce na zatvorenie. Pri spracovaní tejto udalosti zvyčajne zavolajte db.close() a prestaňte spojenie používať. Spojenie, ktoré už čaká na zatvorenie, túto udalosť nedostane, ale môže naďalej blokovať odstránenie, kým sa neskončia jeho prebiehajúce transakcie. Ak niektoré spojenie zostane otvorené, požiadavka vyvolá blocked a čaká. Neznamená to, že odstránenie bolo zrušené alebo zlyhalo, ani že všetky blokujúce spojenia boli upozornené. Započítavajú sa aj spojenia v iných kartách.
Ide o Web API, nie o funkciu konkrétnej edície ECMAScriptu. Prítomnosť Node 24 v repozitári nepotvrdzuje podporu v prehliadači. Spustite príklad v prehliadači, ktorý sprístupňuje IndexedDB. Prístup k úložisku je potrebný na úspešné odstránenie databázy, nie však na spustenie príkladu. Kód ošetruje aj odmietnutie prístupu, ako ukazuje výstup Deletion failed: SecurityError.
Prí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ýsledok
Deletion failed: SecurityError
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.