KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

IDBDatabase — een verbinding met een IndexedDB-database

IDBDatabase vertegenwoordigt een open verbinding met een IndexedDB-database. Je kunt er stores mee maken tijdens schema-upgrades, transacties starten en de verbinding sluiten.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

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();

Je krijgt een IDBDatabase als request.result nadat indexedDB.open() is geslaagd. Dit is een Web-API en geen onderdeel van ECMAScript; Node 24 toont niet aan dat browsers dit ondersteunen. Controleer of indexedDB beschikbaar is in de doelomgeving; de genoemde specificaties zijn geen compatibiliteitstabellen voor browsers.

IDBDatabase.createObjectStore() werkt alleen binnen een actieve upgradetransactie, meestal in upgradeneeded. IDBDatabase.objectStoreNames retourneert een gesorteerde DOMStringList met namen, geen array. Gebruik zo nodig .contains() voordat je een store maakt.

IDBDatabase.transaction() bepaalt het bereik van de stores en de modus: standaard readonly of readwrite. Je kunt hiermee niet handmatig een versionchange-transactie maken. Plan bewerkingen in zolang de transactie actief is; ga er niet van uit dat deze willekeurige await-aanroepen overleeft. Een geslaagd verzoek betekent niet dat de transactie is vastgelegd: wacht op complete van de transactie.

Als reactie op een verzoek om de database met een hoger versienummer te openen of te verwijderen, stuurt IndexedDB de gebeurtenis IDBDatabase.versionchange naar bestaande verbindingen met de database, behalve naar verbindingen waarvoor de vlag close pending is ingesteld. Die verbindingen ontvangen de gebeurtenis niet, ook als ze open blijven totdat hun lopende transacties zijn afgerond. Voor het verzoek is geen bestaande verbinding nodig, en een verwijderverzoek opent geen verbinding. Handel de gebeurtenis af met onversionchange. Dit is iets anders dan upgradeneeded. IDBDatabase.close() voorkomt nieuwe transacties en sluit de verbinding nadat bestaande transacties zijn afgerond, zonder gegevens te verwijderen. Open gelaten verbindingen kunnen upgrades blokkeren.

Voorbeelden

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

Resultaat

Hello

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen