Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

indexedDB.deleteDatabase — eliminar uma base de dados inteira

indexedDB.deleteDatabase(name) elimina assincronamente a base de dados indicada, incluindo os seus dados e estrutura. Devolve um pedido, não uma Promise. As ligações abertas podem bloquear a operação; o evento success confirma a conclusão.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

const request = indexedDB.deleteDatabase(name);

indexedDB.deleteDatabase(name) elimina toda a base de dados indicada no âmbito de armazenamento atual, incluindo arquivos de objetos, índices e registos. Não elimina apenas um registo nem se limita a fechar uma ligação. A operação é destrutiva; utiliza apenas o nome pretendido.

A chamada devolve um IDBOpenDBRequest, não uma Promise: await indexedDB.deleteDatabase(name) não espera pela eliminação. Trata success, error e blocked. Se a base de dados não existir, também ocorre sucesso. Consulta request.error para obter erros assíncronos; a própria chamada também pode lançar sincronamente uma SecurityError.

O IndexedDB envia o evento versionchange com newVersion === null às ligações abertas que ainda não estão assinaladas como estando a aguardar o fecho. Ao receberes este evento, deves, em geral, chamar db.close() e deixar de utilizar a ligação. Uma ligação que já esteja a aguardar o fecho não recebe o evento, mas pode continuar a bloquear a eliminação até terminarem as suas transações em curso. Se alguma ligação permanecer aberta, o pedido gera blocked e aguarda. Isto não significa que a eliminação tenha sido cancelada ou tenha falhado, nem que todas as ligações que a bloqueiam tenham sido notificadas. As ligações noutros separadores também contam.

Esta é uma Web API, não uma funcionalidade de uma edição específica do ECMAScript. A presença de Node 24 num repositório não comprova o suporte nos navegadores. Executa o exemplo num navegador que disponibilize IndexedDB. O acesso ao armazenamento é necessário para que a eliminação seja bem-sucedida, mas não para executar o exemplo. O código trata o caso em que o acesso é recusado, como mostra a mensagem Deletion failed: SecurityError.

Exemplos

(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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes