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

CKTIS / JavaScript

IDBDatabase — povezava z zbirko podatkov IndexedDB

IDBDatabase predstavlja odprto povezavo z zbirko podatkov IndexedDB. Omogoča ustvarjanje shramb med nadgradnjami sheme, zaganjanje transakcij in zapiranje povezave.

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.open(name, version);
// In upgradeneeded:
const store = request.result.createObjectStore(storeName, options);
// After open succeeds:
const db = request.result;
db.objectStoreNames;
const tx = db.transaction(storeNames, "readonly");
db.onversionchange = () => db.close();

IDBDatabase dobiš kot request.result, ko indexedDB.open() uspe. To je spletni API, ne del ECMAScripta; Node 24 ne dokazuje podpore v brskalnikih. Preveri, ali je indexedDB na voljo v ciljnem okolju; navedene specifikacije niso preglednice združljivosti brskalnikov.

IDBDatabase.createObjectStore() deluje samo znotraj aktivne transakcije za nadgradnjo, običajno v upgradeneeded. IDBDatabase.objectStoreNames vrne urejen seznam imen vrste DOMStringList, ne polja. Po potrebi pred ustvarjanjem shrambe uporabi .contains().

IDBDatabase.transaction() določi obseg shramb in način: privzeti readonly ali readwrite. Transakcije versionchange s to metodo ni mogoče ustvariti ročno. Operacije dodajaj, dokler je transakcija aktivna; ne predpostavljaj, da bo ostala aktivna po poljubnih klicih await. Uspešna zahteva ne pomeni, da je transakcija potrjena: počakaj na njen complete.

Kot odziv na zahtevo za odprtje zbirke podatkov z višjo številko različice ali za njen izbris IndexedDB pošlje dogodek IDBDatabase.versionchange obstoječim povezavam z zbirko, razen tistim z nastavljeno zastavico close pending. Te povezave dogodka ne prejmejo, tudi če ostanejo odprte do konca tekočih transakcij. Za oddajo zahteve ni potrebna odprta povezava, zahteva za izbris pa ne odpre povezave. Dogodek obravnavaj z onversionchange. Razlikuje se od upgradeneeded. IDBDatabase.close() prepreči nove transakcije in zapre povezavo, ko se obstoječe končajo, ne da bi izbrisal podatke. Odprte povezave lahko blokirajo nadgradnje.

Primeri

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Using an IDBDatabase connection</title>
</head>
<body>
<script>
  (() => {
    const name = `cktis-connection-${Date.now()}-${Math.random()}`;
    const unavailable = () => console.log('IndexedDB unavailable in this context.');
    let open;
    try {
      // Opening a connection requires a context that permits IndexedDB.
      open = indexedDB.open(name, 1);
    } catch {
      unavailable();
      return;
    }
    open.onerror = unavailable;
    open.onupgradeneeded = () => {
      open.result.createObjectStore('notes', { keyPath: 'id' });
    };
    open.onsuccess = () => {
      const db = open.result;
      const tx = db.transaction('notes', 'readwrite');
      const store = tx.objectStore('notes');
      store.put({ id: 1, text: 'Hello' });
      const read = store.get(1);
      function cleanup() {
        db.close();
        indexedDB.deleteDatabase(name);
      }
      tx.oncomplete = () => {
        console.log(read.result.text);
        cleanup();
      };
      tx.onabort = () => {
        cleanup();
        console.log('Database transaction aborted.');
      };
    };
  })();
</script>
</body>
</html>

Rezultat

Hello

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

Viri