CKTIS / JavaScript
indexedDB.deleteDatabase — eliminare un intero database
indexedDB.deleteDatabase(name) elimina in modo asincrono il database indicato, compresi i dati e la struttura. Restituisce una richiesta, non una Promise. Le connessioni aperte possono bloccare l’operazione; l’evento success ne conferma il completamento.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
const request = indexedDB.deleteDatabase(name);indexedDB.deleteDatabase(name) elimina l’intero database indicato nell’ambito di archiviazione corrente, inclusi archivi di oggetti, indici e record. Non elimina soltanto un record e non si limita a chiudere una connessione. L’operazione è distruttiva; usa esclusivamente il nome previsto.
La chiamata restituisce un IDBOpenDBRequest, non una Promise: await indexedDB.deleteDatabase(name) non attende l’eliminazione. Gestisci success, error e blocked. Anche l’assenza del database comporta un esito positivo. Leggi gli errori asincroni da request.error; la chiamata stessa può inoltre generare sincronicamente una SecurityError.
IndexedDB invia l’evento versionchange con newVersion === null alle connessioni aperte che non sono già contrassegnate come in attesa di chiusura. Quando ricevi questo evento, in genere dovresti chiamare db.close() e smettere di usare la connessione. Una connessione già in attesa di chiusura non riceve l’evento, ma può comunque bloccare l’eliminazione fino al termine delle sue transazioni in corso. Se una connessione rimane aperta, la richiesta genera blocked e attende. Questo non significa che l’eliminazione sia stata annullata o non sia riuscita, né che tutte le connessioni che la bloccano siano state avvisate. Contano anche le connessioni in altre schede.
Questa è una Web API, non una funzionalità di una specifica edizione di ECMAScript. La presenza di Node 24 in un repository non dimostra il supporto nei browser. Esegui l’esempio in un browser che metta a disposizione IndexedDB. L’accesso allo spazio di archiviazione è necessario perché l’eliminazione riesca, ma non per eseguire l’esempio. Il codice gestisce il caso in cui l’accesso viene negato, come mostra il messaggio Deletion failed: SecurityError.
Esempi
(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}`);
}
})();Risultato
Deletion failed: SecurityError
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.