KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

IDBRequest — resultaat van een IndexedDB-bewerking

IDBRequest geeft via gebeurtenissen het resultaat of de fout van een asynchrone IndexedDB-bewerking beschikbaar. Een geslaagde aanvraag betekent nog niet dat de volledige transactie is vastgelegd.

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

request.result
request.error
request.onsuccess = (event) => { /* read request.result */ };
request.onerror = (event) => { /* read request.error */ };

IDBRequest is een EventTarget-object dat wordt teruggegeven door IndexedDB-bewerkingen zoals get(). Het is geen Promise: alleen await request gebruiken wacht niet op het resultaat. Het hoort bij de Web API's, niet bij ECMAScript; de aanwezigheid van Node 24 bewijst niet dat deze API in de browser beschikbaar is.

IDBRequest.result bevat een bewerkingsafhankelijk resultaat; na een fout geeft het undefined terug. IDBRequest.error geeft na een fout een DOMException terug of na succes null. Het lezen van een van beide eigenschappen wanneer readyState === "pending" veroorzaakt InvalidStateError. Een ontbrekend record bij get() is een geslaagde bewerking met als resultaat undefined, geen fout.

IDBRequest.onsuccess verwerkt de gebeurtenis success, en IDBRequest.onerror verwerkt error. Een aanvraagfout breekt standaard de bijbehorende transactie af; alleen een handler toewijzen verandert dit niet. Succes van de aanvraag garandeert niet dat de transactie wordt vastgelegd: houd ook de gebeurtenissen complete en abort van de transactie in de gaten.

Het voorbeeld opent een database met IDBOpenDBRequest, een subtype van IDBRequest. De schrijf- en leesbewerking worden in dezelfde transactie in de wachtrij gezet. Als get() slaagt, schrijft de bijbehorende onsuccess-handler request.result naar de console voordat de transactie de gebeurtenis complete activeert, als het zover komt. De getoonde melding IndexedDB unavailable: SecurityError komt van een foutpad waarop de leesbewerking niet wordt bereikt.

Voorbeelden

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>IDBRequest: operation success and transaction completion</title>
</head>
<body>
  <h1>Observing an IndexedDB request</h1>
  <script>
    (() => {
      const name = 'cktis-request-' + crypto.getRandomValues(new Uint32Array(4)).join('-');
      const report = error => console.log(error.name === 'SecurityError'
        ? 'IndexedDB unavailable: SecurityError' : `IndexedDB error: ${error.name}`);
      let factory, opening;
      try {
        factory = window.indexedDB;
        if (!factory) {
          console.log('IndexedDB unavailable: API missing');
          return;
        }
        opening = factory.open(name, 1);
      } catch (error) {
        report(error);
        return;
      }
      let created = false;
      opening.onerror = () => report(opening.error);
      opening.onupgradeneeded = () => {
        created = true;
        opening.result.createObjectStore('values');
      };
      opening.onsuccess = () => {
        const db = opening.result;
        if (!created) {
          db.close();
          console.log('Fixture name already in use');
          return;
        }
        const tx = db.transaction('values', 'readwrite');
        const store = tx.objectStore('values');
        store.put('circle', 'shape');
        const request = store.get('shape');
        const cleanup = () => {
          db.close();
          factory.deleteDatabase(name);
        };
        console.log(`get before events: ${request.readyState}`);
        request.onsuccess = () => {
          console.log(`get success: ${request.readyState}, value: ${request.result}`);
        };
        request.onerror = () => console.log(`get error: ${request.error.name}`);
        tx.oncomplete = event => {
          console.log(`transaction: ${event.type}`);
          cleanup();
        };
        tx.onabort = event => {
          console.log(`transaction: ${event.type}`);
          cleanup();
        };
      };
    })();
  </script>
</body>
</html>

Resultaat

IndexedDB unavailable: SecurityError

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