Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

indexedDB.deleteDatabase — brisanje celotne podatkovne zbirke

indexedDB.deleteDatabase(name) asinhrono izbriše imenovano podatkovno zbirko, vključno z njenimi podatki in strukturo. Vrne zahtevo, ne Promise. Odprte povezave lahko operacijo blokirajo; njen zaključek potrdi dogodek success.

Različica: 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) izbriše celotno imenovano podatkovno zbirko v trenutnem obsegu shrambe, vključno s shrambami objektov, indeksi in zapisi. Ne izbriše samo enega zapisa in tudi ne zgolj zapre povezave. Operacija je destruktivna; uporabi samo predvideno ime.

Klic vrne IDBOpenDBRequest, ne Promise: await indexedDB.deleteDatabase(name) ne počaka na izbris. Obravnavaj dogodke success, error in blocked. Uspeh nastopi tudi, če podatkovna zbirka ne obstaja. Asinhrone napake preberi iz request.error; klic lahko tudi sinhrono sproži SecurityError.

IndexedDB pošlje dogodek versionchange z newVersion === null odprtim povezavam, ki še niso označene kot čakajoče na zaprtje. Ob tem dogodku praviloma pokliči db.close() in prenehaj uporabljati povezavo. Povezava, ki že čaka na zaprtje, tega dogodka ne prejme, vendar lahko še vedno blokira izbris, dokler se njene tekoče transakcije ne končajo. Če katera povezava ostane odprta, zahteva sproži blocked in čaka. To ne pomeni, da je bil izbris preklican ali neuspešen, niti da so bile obveščene vse povezave, ki ga blokirajo. Štejejo tudi povezave v drugih zavihkih.

To je spletni API, ne funkcija določene izdaje ECMAScripta. Prisotnost Node 24 v repozitoriju ne dokazuje podpore v brskalnikih. Zaženi primer v brskalniku, v katerem je na voljo IndexedDB. Dostop do shrambe je potreben za uspešen izbris, ne pa za zagon primera. Koda obravnava tudi zavrnjen dostop, kot kaže izpis Deletion failed: SecurityError.

Primeri

(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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri