KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

IndexedDB: objectstores aanmaken en transacties openen

Wijzig het schema bij een versie-upgrade met `createObjectStore()` en lees of schrijf records in bestaande objectstores met `transaction()`.

Versie: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

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 staat voor een open verbinding met een IndexedDB-database. db.createObjectStore(name, options) geeft meteen een nieuwe IDBObjectStore terug, maar werkt alleen in een actieve versionchange-transactie. IndexedDB start die transactie wanneer indexedDB.open() de database aanmaakt of met een hoger versienummer opent. Wijzig het schema in upgradeneeded. Een open verbinding in een ander tabblad kan de upgrade blokkeren: het openingsverzoek geeft blocked en de oude verbinding kan als reactie op versionchange close() aanroepen.

De optionele keyPath geeft aan waar de sleutel uit de waarde wordt gehaald, bijvoorbeeld uit id. Een array van paden levert een samengestelde sleutel op; zonder pad wordt de sleutel apart opgeslagen. autoIncrement is standaard false; true schakelt een sleutelgenerator in, maar is niet te combineren met een lege tekenreeks of een array als keyPath (InvalidAccessError). Een dubbele storenaam geeft ConstraintError, een ongeldig sleutelpad SyntaxError en een aanroep zonder upgradetransactie InvalidStateError.

db.transaction(storeNames, mode, options) geeft meteen een IDBTransaction terug. Het bereik wordt bepaald door één storenaam als tekenreeks of door een niet-leeg itereerbaar object met namen van bestaande stores, zoals een array of een Set. Gebruik tx.objectStore(name) om een store uit dat bereik te openen. De standaardmodus "readonly" staat alleen lezen toe; "readwrite" staat ook schrijven toe. Je kunt hier niet "versionchange" kiezen (TypeError). Een onbekende store geeft NotFoundError, een lege lijst InvalidAccessError en een verbinding die sluit of al gesloten is InvalidStateError. De optionele options.durability ("default", "strict", "relaxed") geeft een voorkeur voor de duurzaamheid bij de commit; controleer ondersteuning in de doelbrowsers.

Plaats verzoeken alleen in de wachtrij zolang de transactie actief is: in de taak die haar heeft aangemaakt of in een success- of error-handler van een van haar verzoeken. Na await fetch(...) kan de transactie al automatisch zijn vastgelegd; een later verzoek kan TransactionInactiveError opleveren. Een geslaagd verzoek betekent niet dat de transactie is geslaagd. complete bevestigt de commit; abort betekent dat wijzigingen zijn teruggedraaid.

IndexedDB is een web-API en maakt geen deel uit van ECMAScript 2024. Toegang is beperkt tot dezelfde origin; browserinstellingen kunnen de opslagtoegang of de bewaartermijn beperken.

Voorbeelden

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

Resultaat

IndexedDB

Bied het HTML-bestand aan via HTTPS en open het in een browser waarin opslag is toegestaan. Het voorbeeld maakt een database met een willekeurige naam, leest het record nadat de schrijftransactie is vastgelegd, sluit en verwijdert de database en toont daarna `IndexedDB` in de browserconsole.

Gerelateerde lessen

  • JavaScript · Les 31 · Gevorderd · Versie: 4

Bronnen