Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

indexedDB.deleteDatabase — brisanje cijele baze podataka

indexedDB.deleteDatabase(name) asinkrono briše imenovanu bazu podataka, uključujući njezine podatke i strukturu. Vraća zahtjev, a ne Promise. Otvorene veze mogu blokirati postupak; događaj success potvrđuje dovršetak.

Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

const request = indexedDB.deleteDatabase(name);

indexedDB.deleteDatabase(name) briše cijelu imenovanu bazu podataka u trenutačnom opsegu pohrane, uključujući spremišta objekata, indekse i zapise. Ne briše samo jedan zapis niti samo zatvara vezu. Postupak je destruktivan; upotrijebi isključivo željeni naziv.

Poziv vraća IDBOpenDBRequest, a ne Promise: await indexedDB.deleteDatabase(name) ne čeka brisanje. Obradi događaje success, error i blocked. Uspjeh se javlja i ako baza podataka ne postoji. Asinkrone pogreške pročitaj iz request.error; sam poziv može i sinkrono izazvati SecurityError.

IndexedDB šalje događaj versionchange s newVersion === null otvorenim vezama koje još nisu označene kao veze koje čekaju zatvaranje. Pri obradi tog događaja u pravilu pozovi db.close() i prestani se koristiti vezom. Veza koja već čeka zatvaranje ne prima taj događaj, ali može i dalje blokirati brisanje dok se ne dovrše njezine tekuće transakcije. Ako neka veza ostane otvorena, zahtjev pokreće blocked i čeka. To ne znači da je brisanje otkazano ili neuspješno, niti da su obaviještene sve veze koje ga blokiraju. Računaju se i veze u drugim karticama.

Ovo je Web API, a ne značajka određenog izdanja ECMAScripta. Prisutnost Nodea 24 u repozitoriju ne dokazuje podršku u pregledniku. Pokreni primjer u pregledniku u kojem je dostupan IndexedDB. Pristup pohrani potreban je za uspješno brisanje, ali ne i za pokretanje primjera. Kôd obrađuje i slučaj u kojem je pristup odbijen, što pokazuje ispis Deletion failed: SecurityError.

Primjeri

(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}`);
  }
})();

Rezultat

Deletion failed: SecurityError

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori