CKTIS / JavaScript
indexedDB.deleteDatabase — usuwanie całej bazy danych
indexedDB.deleteDatabase(name) asynchronicznie usuwa wskazaną bazę wraz z jej danymi i strukturą. Zwraca żądanie, nie Promise. Otwarte połączenia mogą wstrzymać operację; jej zakończenie potwierdza zdarzenie success.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
const request = indexedDB.deleteDatabase(name);indexedDB.deleteDatabase(name) usuwa całą nazwaną bazę, w tym magazyny obiektów, indeksy i rekordy, w bieżącym zakresie przechowywania. To nie jest usuwanie pojedynczego rekordu ani samo zamknięcie połączenia. Operacja jest destrukcyjna; używaj wyłącznie zamierzonej nazwy.
Wynikiem wywołania jest IDBOpenDBRequest, nie Promise: await indexedDB.deleteDatabase(name) nie czeka na usunięcie. Obsłuż success, error i blocked. Brak bazy również kończy się sukcesem. Błędy asynchroniczne odczytuj z request.error; samo wywołanie może też synchronicznie zgłosić SecurityError.
IndexedDB wysyła zdarzenie versionchange z newVersion === null do otwartych połączeń, które nie są jeszcze oznaczone jako oczekujące na zamknięcie. Po odebraniu zdarzenia zwykle należy wywołać db.close() i przestać używać połączenia. Połączenie oczekujące już na zamknięcie nie otrzymuje tego zdarzenia, ale nadal może wstrzymywać usunięcie, dopóki nie zakończą się jego trwające transakcje. Jeśli jakieś połączenie nadal jest otwarte, żądanie zgłasza blocked i czeka. Nie oznacza to anulowania ani niepowodzenia, ani też tego, że powiadomiono każde połączenie wstrzymujące usunięcie. Dotyczy to również połączeń w innych kartach.
To Web API, a nie funkcja określonej edycji ECMAScript. Obecność Node 24 w repozytorium nie potwierdza obsługi w przeglądarce. Uruchom przykład w przeglądarce udostępniającej IndexedDB. Dostęp do pamięci jest potrzebny do pomyślnego usunięcia bazy, ale nie do uruchomienia przykładu. Kod obsługuje odmowę dostępu: to właśnie ten przypadek pokazuje wynik Deletion failed: SecurityError.
Przykłady
(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}`);
}
})();Wynik
Deletion failed: SecurityError
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.