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

CKTIS / JavaScript

IDBDatabase — una conexión a una base de datos IndexedDB

IDBDatabase representa una conexión abierta a una base de datos IndexedDB. Permite crear almacenes durante las actualizaciones del esquema, iniciar transacciones y cerrar la conexió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

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

Obtienes un IDBDatabase en request.result cuando indexedDB.open() se completa correctamente. Es una API web, no forma parte de ECMAScript; Node 24 no demuestra la compatibilidad de los navegadores. Comprueba si indexedDB está disponible en el entorno de destino; las especificaciones citadas no son tablas de compatibilidad de navegadores.

IDBDatabase.createObjectStore() solo funciona dentro de una transacción de actualización activa, normalmente en upgradeneeded. IDBDatabase.objectStoreNames devuelve una DOMStringList ordenada de nombres, no un array. Si hace falta, usa .contains() antes de crear un almacén.

IDBDatabase.transaction() especifica el ámbito de los almacenes y el modo: readonly de forma predeterminada o readwrite. No permite crear manualmente una transacción versionchange. Encola las operaciones mientras la transacción esté activa; no des por hecho que seguirá activa tras llamadas await arbitrarias. Que una solicitud tenga éxito no significa que la transacción se haya confirmado: espera a complete de la transacción.

Cuando se solicita abrir la base de datos con un número de versión mayor o eliminarla, IndexedDB envía el evento IDBDatabase.versionchange a las conexiones existentes con la base, salvo a las que tienen activado el indicador close pending. Esas conexiones no reciben el evento aunque sigan abiertas hasta que terminen sus transacciones en curso. No hace falta tener una conexión abierta para realizar la solicitud, y una solicitud de eliminación no abre ninguna conexión. Gestiona el evento mediante onversionchange. No es lo mismo que upgradeneeded. IDBDatabase.close() impide nuevas transacciones y cierra la conexión cuando terminan las existentes, sin eliminar los datos. Las conexiones que se dejan abiertas pueden bloquear las actualizaciones.

Ejemplos

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

Resultado

Hello

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