Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

indexedDB.deleteDatabase — supprimer une base de données entière

indexedDB.deleteDatabase(name) supprime de façon asynchrone la base de données nommée, avec ses données et sa structure. La méthode renvoie une requête, pas une Promise. Les connexions ouvertes peuvent bloquer l’opération ; l’événement success en confirme la fin.

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

Syntaxe

const request = indexedDB.deleteDatabase(name);

indexedDB.deleteDatabase(name) supprime toute la base de données nommée dans le périmètre de stockage actuel, y compris ses magasins d’objets, ses index et ses enregistrements. Il ne s’agit ni de supprimer un seul enregistrement ni simplement de fermer une connexion. L’opération est destructive ; utilisez uniquement le nom voulu.

L’appel renvoie un IDBOpenDBRequest, pas une Promise : await indexedDB.deleteDatabase(name) n’attend pas la suppression. Gérez success, error et blocked. L’absence de la base entraîne également un succès. Consultez request.error pour les erreurs asynchrones ; l’appel lui-même peut aussi déclencher synchroniquement une SecurityError.

IndexedDB envoie l’événement versionchange avec newVersion === null aux connexions ouvertes qui ne sont pas déjà marquées comme étant en attente de fermeture. À la réception de cet événement, il convient généralement d’appeler db.close() et de cesser d’utiliser la connexion. Une connexion déjà en attente de fermeture ne reçoit pas cet événement, mais peut encore bloquer la suppression jusqu’à la fin de ses transactions en cours. Si une connexion reste ouverte, la requête déclenche blocked et attend. Cela ne signifie ni que la suppression a été annulée ou a échoué, ni que toutes les connexions qui la bloquent ont été notifiées. Les connexions ouvertes dans d’autres onglets sont également concernées.

Il s’agit d’une API Web, et non d’une fonctionnalité d’une édition particulière d’ECMAScript. La présence de Node 24 dans un dépôt ne prouve pas la prise en charge par les navigateurs. Exécutez l’exemple dans un navigateur qui met IndexedDB à disposition. L’accès au stockage est nécessaire pour que la suppression réussisse, mais pas pour exécuter l’exemple. Le code gère le refus d’accès, comme l’illustre le message affiché Deletion failed: SecurityError.

Exemples

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

Résultat

Deletion failed: SecurityError

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources