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

CKTIS / JavaScript

IndexedDB: ustvarjanje shramb objektov in odpiranje transakcij

Z `createObjectStore()` spremeniš shemo ob nadgradnji zbirke podatkov, s `transaction()` pa bereš ali zapisuješ zapise v obstoječih shrambah objektov.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

db.createObjectStore(name) → IDBObjectStore
db.createObjectStore(name, options) → IDBObjectStore

db.transaction(storeNames) → IDBTransaction
db.transaction(storeNames, mode) → IDBTransaction
db.transaction(storeNames, mode, options) → IDBTransaction

IDBDatabase predstavlja odprto povezavo z zbirko podatkov IndexedDB. db.createObjectStore(name, options) takoj vrne nov IDBObjectStore, vendar deluje samo v aktivni transakciji versionchange. IndexedDB jo zažene, ko indexedDB.open() ustvari zbirko ali jo odpre z višjo različico. Shemo spremeni v obravnavalniku upgradeneeded. Odprta povezava v drugem zavihku lahko blokira nadgradnjo: zahteva za odpiranje sproži blocked, stara povezava pa lahko ob versionchange pokliče close().

Neobvezni keyPath določa, od kod v vrednosti se vzame ključ, denimo iz id. Seznam poti določa sestavljeni ključ; brez poti se ključ shrani ločeno. Privzeta vrednost autoIncrement je false; true vklopi generator ključev, vendar ga ni mogoče združiti s praznim nizom ali seznamom poti kot keyPath (InvalidAccessError). Podvojeno ime shrambe povzroči ConstraintError, neveljavna pot ključa SyntaxError, klic brez transakcije za nadgradnjo pa InvalidStateError.

db.transaction(storeNames, mode, options) takoj vrne IDBTransaction, katere obseg določa ime ene shrambe, podano kot niz, ali neprazen iterabilni objekt z imeni obstoječih shramb, na primer polje ali Set. Do shrambe v tem obsegu dostopaš z tx.objectStore(name). Privzeti način "readonly" omogoča le branje; "readwrite" omogoča tudi pisanje. Načina "versionchange" tu ni mogoče izbrati (TypeError). Neznana shramba povzroči NotFoundError, prazen seznam InvalidAccessError, zaprta povezava ali povezava v zapiranju pa InvalidStateError. Neobvezni options.durability ("default", "strict", "relaxed") podaja želeno trajnost podatkov ob potrditvi; preveri podporo v ciljnih brskalnikih.

Zahteve dodajaj le, ko je transakcija aktivna: v opravilu, ki jo je ustvarilo, ali v obravnavalniku success ali error ene od njenih zahtev. Po await fetch(...) je transakcija lahko že samodejno potrjena in poznejša zahteva lahko sproži TransactionInactiveError. Uspeh zahteve še ne pomeni uspeha transakcije. complete potrdi uspešen zaključek transakcije, abort pa pomeni, da so bile spremembe razveljavljene.

IndexedDB je spletni API, ne del ECMAScript 2024. Dostop je omejen na isti izvor; nastavitve brskalnika lahko omejijo dostop do shrambe ali čas hranjenja podatkov.

Primeri

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>IndexedDB example</title>
</head>
<body>
<script>
(async () => {
  const idb = window.indexedDB;
  const name = `cktis-notes-${crypto.randomUUID()}`;
  const requestResult = (request) => new Promise((resolve, reject) => {
    request.onsuccess = () => resolve(request.result);
    request.onerror = () => reject(request.error);
  });
  const finished = (tx) => new Promise((resolve, reject) => {
    tx.oncomplete = () => resolve();
    tx.onabort = () => reject(tx.error ?? new Error("Transaction aborted"));
  });

  const open = idb.open(name, 1);
  open.onupgradeneeded = () => {
    open.result.createObjectStore("notes", { keyPath: "id" });
  };
  const db = await requestResult(open);
  db.onversionchange = () => db.close();

  let title;
  try {
    const write = db.transaction("notes", "readwrite");
    write.objectStore("notes").put({ id: 1, title: "IndexedDB" });
    await finished(write);

    const read = db.transaction("notes");
    const get = read.objectStore("notes").get(1);
    await finished(read);
    title = get.result.title;
  } finally {
    db.close();
    await requestResult(idb.deleteDatabase(name));
  }
  console.log(title);
})().catch((error) => console.error(error));
</script>
</body>
</html>

Rezultat

IndexedDB

Datoteko HTML daj na voljo prek HTTPS in jo odpri v brskalniku, v katerem je shranjevanje dovoljeno. Primer ustvari zbirko z naključnim imenom, po potrditvi pisanja prebere zapis, zapre in izbriše zbirko ter nato v konzolo brskalnika izpiše `IndexedDB`.

Povezane lekcije

  • JavaScript · Lekcija 31 · Napredna · Različica: 4

Viri