WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

indexedDB.open — Datenbank öffnen und Schema aktualisieren

indexedDB.open öffnet oder erstellt asynchron eine lokale Datenbank. Die Methode gibt eine ereignisgesteuerte Anfrage zurück; Schemaänderungen gehören in den Handler für upgradeneeded.

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

Syntax

indexedDB.open(name)
indexedDB.open(name, version)

indexedDB.open(name, version) gibt ein IDBOpenDBRequest zurück, kein Promise. Bei success enthält request.result eine IDBDatabase-Verbindung. Wird version weggelassen, gilt die aktuelle Datenbankversion oder für eine neue Datenbank 1.

Die Version ist eine positive Ganzzahl. Eine höhere Version löst upgradeneeded aus: Erstelle Objektspeicher und Indizes innerhalb dieser Aktualisierungstransaktion. success tritt erst ein, nachdem die Aktualisierung übernommen wurde. Eine niedrigere Version führt asynchron zu einem VersionError; 0 löst synchron einen TypeError aus.

Andere offene Verbindungen können blocked auslösen; das bedeutet, dass gewartet wird, nicht dass der Vorgang endgültig fehlgeschlagen ist. Schließe sie als Reaktion auf versionchange mit db.close(). Behandle sowohl error als auch synchrone Ausnahmen.

Dies ist eine Web API und kein Bestandteil von ECMAScript. Prüfe die Verfügbarkeit im Zielbrowser; Node 24 belegt sie nicht. Die Speicherungsrichtlinie kann den Zugriff verweigern. Gelingt das Öffnen, schließt das Beispiel die Verbindung und fordert mit indexedDB.deleteDatabase(name) das Löschen der Datenbank an. Im gezeigten Fall mit SecurityError wird keine Datenbank erstellt.

Beispiele

(() => {
  const name = `cktis-open-${crypto.getRandomValues(new Uint32Array(4)).join('-')}`;
  const failed = error => console.log(`Open failed: ${error.name}`);

  try {
    const request = indexedDB.open(name, 1);
    let upgradedFrom;
    request.onupgradeneeded = event => {
      upgradedFrom = event.oldVersion;
      request.result.createObjectStore('notes');
    };
    request.onblocked = () => console.log('Open blocked by an open connection');
    request.onerror = () => failed(request.error);
    request.onsuccess = () => {
      const db = request.result;
      const version = db.version;
      const hasNotes = db.objectStoreNames.contains('notes');
      db.close();
      indexedDB.deleteDatabase(name);
      console.log(`Opened version ${version} from ${upgradedFrom}; notes store: ${hasNotes}`);
    };
  } catch (error) {
    failed(error);
  }
})();

Ergebnis

Open failed: SecurityError

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen