Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

IndexedDB: stvaranje spremišta objekata i otvaranje transakcija

Upotrijebi `createObjectStore()` za promjenu sheme pri nadogradnji baze, a `transaction()` za čitanje ili pisanje zapisa u postojećim spremištima.

Verzija: 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 otvorenu vezu s bazom IndexedDB. db.createObjectStore(name, options) odmah vraća novi IDBObjectStore, ali radi samo unutar aktivne transakcije versionchange. IndexedDB je pokreće kad indexedDB.open() stvara bazu ili je otvara s višom verzijom. Shemu mijenjaj u rukovatelju događajem upgradeneeded. Otvorena veza na drugoj kartici može blokirati nadogradnju: zahtjev za otvaranje izaziva blocked, a stara veza može pozvati close() kao odgovor na versionchange.

Neobavezni keyPath određuje odakle se iz vrijednosti uzima ključ, primjerice iz id. Niz putanja definira složeni ključ; bez putanje ključ se pohranjuje zasebno. Zadana vrijednost za autoIncrement je false; true uključuje generator ključeva, ali ne može se kombinirati s praznim znakovnim nizom ili nizom putanja kao keyPath (InvalidAccessError). Duplicirano ime spremišta uzrokuje ConstraintError, nevaljana putanja ključa SyntaxError, a poziv bez transakcije nadogradnje InvalidStateError.

db.transaction(storeNames, mode, options) odmah vraća IDBTransaction čiji opseg određuje jedno ime spremišta zadano kao znakovni niz ili neprazan iterabilni objekt s imenima postojećih spremišta, primjerice niz ili Set. Spremištu iz tog opsega pristupi preko tx.objectStore(name). Zadani način "readonly" dopušta samo čitanje; "readwrite" dopušta i pisanje. Ovdje ne možeš odabrati "versionchange" (TypeError). Nepoznato spremište uzrokuje NotFoundError, prazan popis InvalidAccessError, a zatvorena veza ili veza koja se zatvara InvalidStateError. Neobavezni options.durability ("default", "strict", "relaxed") izražava željenu trajnost podataka pri potvrdi transakcije; provjeri podršku u ciljanim preglednicima.

Zahtjeve stavljaj u red samo dok je transakcija aktivna: u zadatku koji ju je stvorio ili u rukovatelju success ili error nekog od njezinih zahtjeva. Nakon await fetch(...) transakcija se možda već automatski potvrdila pa kasniji zahtjev može izazvati TransactionInactiveError. Uspjeh zahtjeva ne znači da je uspjela i transakcija. complete potvrđuje dovršetak transakcije, a abort znači da su promjene poništene.

IndexedDB je web-API, a ne dio ECMAScripta 2024. Pristup je ograničen na isto podrijetlo (origin); postavke preglednika mogu ograničiti pristup pohrani ili vrijeme čuvanja podataka.

Primjeri

<!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

Posluži HTML datoteku putem HTTPS-a i otvori je u pregledniku u kojem je pohrana dopuštena. Primjer stvara bazu s nasumičnim imenom, čita zapis nakon potvrde pisanja, zatvara i briše bazu te na kraju ispisuje `IndexedDB` u konzoli preglednika.

Povezane lekcije

  • JavaScript · Lekcija 31 · Napredno · Verzija: 4

Izvori