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

CKTIS / JavaScript

indexedDB.open — abrir una base de datos y actualizar su esquema

indexedDB.open abre o crea de forma asíncrona una base de datos local. Devuelve una solicitud basada en eventos; los cambios del esquema se realizan en el controlador upgradeneeded.

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

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

indexedDB.open(name, version) devuelve un IDBOpenDBRequest, no una Promise. En success, request.result contiene una conexión IDBDatabase. Si se omite version, se usa la versión actual de la base de datos o 1 si es nueva.

La versión es un entero positivo. Una versión superior activa upgradeneeded: crea almacenes de objetos e índices dentro de esta transacción de actualización. success solo ocurre después de que se confirme la actualización. Una versión inferior provoca un VersionError asíncrono; 0 lanza un TypeError síncrono.

Otras conexiones abiertas pueden provocar blocked; esto significa que hay que esperar, no que el fallo sea definitivo. Ciérralas con db.close() como respuesta a versionchange. Gestiona tanto error como las excepciones síncronas.

Es una Web API, no forma parte de ECMAScript. Comprueba su disponibilidad en el navegador de destino; Node 24 no la demuestra. La política de almacenamiento puede denegar el acceso. Si la apertura tiene éxito, el ejemplo cierra la conexión y solicita la eliminación de la base de datos con indexedDB.deleteDatabase(name). En el caso mostrado, con un error SecurityError, no se crea ninguna base de datos.

Ejemplos

(() => {
  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);
  }
})();

Resultado

Open failed: 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