Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje