База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

indexedDB.deleteDatabase — изтриване на цяла база данни

indexedDB.deleteDatabase(name) асинхронно изтрива посочената база данни заедно с данните и структурата ѝ. Връща заявка, а не Promise. Отворените връзки могат да блокират операцията; събитието success потвърждава завършването ѝ.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

const request = indexedDB.deleteDatabase(name);

indexedDB.deleteDatabase(name) изтрива цялата посочена база данни в текущия обхват на съхранение, включително хранилищата за обекти, индексите и записите. Не изтрива само един запис и не просто затваря връзка. Операцията е разрушителна; използвайте само предвиденото име.

Извикването връща IDBOpenDBRequest, а не Promise: await indexedDB.deleteDatabase(name) не изчаква изтриването. Обработвайте success, error и blocked. Успех има и когато базата данни липсва. Четете асинхронните грешки от request.error; самото извикване може също синхронно да предизвика SecurityError.

IndexedDB изпраща събитието versionchange с newVersion === null до отворените връзки, които още не са отбелязани като чакащи затваряне. При получаване на това събитие обикновено трябва да извикате db.close() и да спрете да използвате връзката. Връзка, която вече чака затваряне, не получава това събитие, но все още може да блокира изтриването, докато текущите ѝ транзакции приключат. Ако някоя връзка остане отворена, заявката задейства blocked и изчаква. Това не означава, че изтриването е отменено или неуспешно, нито че всички блокиращи връзки са били уведомени. Връзките в други раздели също се броят.

Това е Web API, а не функция на конкретно издание на ECMAScript. Наличието на Node 24 в хранилище не доказва поддръжка в браузър. Изпълнете примера в браузър, който предоставя IndexedDB. Достъпът до хранилището е необходим за успешно изтриване, но не и за изпълнение на примера. Кодът обработва отказа на достъп, както показва изведеният резултат Deletion failed: SecurityError.

Примери

(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}`);
  }
})();

Резултат

Deletion failed: SecurityError

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници