CKTIS / JavaScript
indexedDB.deleteDatabase — eliminar una base de datos completa
indexedDB.deleteDatabase(name) elimina de forma asíncrona la base de datos indicada, incluidos sus datos y su estructura. Devuelve una solicitud, no una Promise. Las conexiones abiertas pueden bloquear la operación; el evento success confirma que ha terminado.
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.deleteDatabase(name);indexedDB.deleteDatabase(name) elimina toda la base de datos indicada en el ámbito de almacenamiento actual, incluidos los almacenes de objetos, los índices y los registros. No elimina solo un registro ni se limita a cerrar una conexión. La operación es destructiva; utiliza únicamente el nombre previsto.
La llamada devuelve un IDBOpenDBRequest, no una Promise: await indexedDB.deleteDatabase(name) no espera a que se complete la eliminación. Gestiona success, error y blocked. Si la base de datos no existe, también se produce un resultado satisfactorio. Consulta request.error para los errores asíncronos; la propia llamada también puede lanzar sincrónicamente un SecurityError.
IndexedDB envía el evento versionchange con newVersion === null a las conexiones abiertas que aún no están marcadas como pendientes de cierre. Al recibir este evento, por lo general debes llamar a db.close() y dejar de usar la conexión. Una conexión que ya está pendiente de cierre no recibe el evento, pero puede seguir bloqueando la eliminación hasta que terminen sus transacciones en curso. Si alguna conexión sigue abierta, la solicitud emite blocked y espera. Esto no significa que la eliminación se haya cancelado o haya fallado, ni que se haya notificado a todas las conexiones que la bloquean. También cuentan las conexiones de otras pestañas.
Esta es una API web, no una característica de una edición concreta de ECMAScript. Que Node 24 esté en un repositorio no demuestra que haya compatibilidad con navegadores. Ejecuta el ejemplo en un navegador que ofrezca IndexedDB. El acceso al almacenamiento es necesario para que la eliminación se complete correctamente, pero no para ejecutar el ejemplo. El código gestiona la denegación de acceso, que es el caso que ilustra la salida Deletion failed: SecurityError.
Ejemplos
(async () => {
const name = `cktis-delete-${crypto.getRandomValues(new Uint32Array(4)).join('-')}`;
const result = request => new Promise((resolve, reject) => {
request.onsuccess = () => resolve(request.result);
request.onerror = () => reject(request.error);
});
try {
try {
const seed = indexedDB.open(name, 1);
seed.onupgradeneeded = () => {
seed.result.createObjectStore('items').put('fixture', 'key');
};
const db = await result(seed);
db.close();
} catch (error) {
if (error.name !== 'SecurityError') throw error;
// Still exercise deleteDatabase when fixture creation is denied.
}
const deletion = indexedDB.deleteDatabase(name);
deletion.onblocked = () => console.log('Deletion blocked by an open connection');
deletion.onerror = () => console.log(`Deletion failed: ${deletion.error.name}`);
deletion.onsuccess = event => {
console.log(`Deletion complete: old version ${event.oldVersion}, new version ${event.newVersion}`);
};
} catch (error) {
console.log(`Deletion failed: ${error.name}`);
}
})();Resultado
Deletion 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.