Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

IDBRequest — resultado de una operación de IndexedDB

IDBRequest expone mediante eventos el resultado o el error de una operación asíncrona de IndexedDB. Que una solicitud tenga éxito no significa todavía que se haya confirmado toda la transacción.

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

Sintaxis

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

IDBRequest es un objeto EventTarget que devuelven operaciones de IndexedDB como get(). No es una Promise: usar await request por sí solo no espera al resultado. Forma parte de las Web APIs, no de ECMAScript; que Node 24 esté disponible no demuestra que esta API esté disponible en el navegador.

IDBRequest.result contiene un resultado que depende de la operación; después de un error devuelve undefined. IDBRequest.error devuelve una DOMException si hay un error o null si la operación tiene éxito. Leer cualquiera de estas propiedades cuando readyState === "pending" provoca InvalidStateError. Si get() no encuentra un registro, el resultado es undefined y la operación tiene éxito; no es un error.

IDBRequest.onsuccess gestiona el evento success, e IDBRequest.onerror gestiona error. De forma predeterminada, un error de solicitud aborta la transacción asociada; asignar un controlador no cambia esto. El éxito de una solicitud no garantiza que se confirme la transacción: observa también sus eventos complete y abort.

El ejemplo abre una base de datos mediante IDBOpenDBRequest, un subtipo de IDBRequest. La escritura y la lectura se ponen en cola en la misma transacción. Si get() tiene éxito, su controlador onsuccess muestra request.result antes de que se dispare el evento complete de la transacción, si llega a dispararse. El mensaje mostrado, IndexedDB unavailable: SecurityError, corresponde a un caso de error en el que no se llega a la lectura.

Ejemplos

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

Resultado

IndexedDB unavailable: SecurityError

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes