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.